Skip to main content

Jama Connect User Guide

Best practices and guardrails

Best practices and guardrails provide proven guidance that helps you get the most out of your experience with the Jama Connect application.

Change/use this...

For this result...

Explorer Tree settings

When your project has a large number of items, you can improve performance by changing the Explorer Tree settings to only show folders and components.


Filters that run against all projects find and display results for all items in your Jama Connect application. Filters like these can return large data sets and degrade performance. To assure quality performance, make filters more specific to return only the results you need.

Items and attachments

When working with more than 1,000 items per folder, hide items in the Explorer Tree and work with them in List View in the center panel. To move multiple items, multi-select in List View and drag them to their new location in the Explorer Tree.

Files larger than 25 MB aren't indexed so their content isn't searchable.

  • Indexed file types: PDF, DOC, DOCX, PPT, PPTX, TXT, RTF

  • Non-indexed file types: XLSX, XLS, XML, HTML, HTM

Item field content

Keep the content of item fields to fewer than 10,000 characters (2,000 words). When you compare review versions, the applications might skip fields with lengthy content.

Reuse and synchronization of hundreds of items can affect system performance, causing it to feel slower than usual for users and decrease performance for other processes such as exporting.

Reuse and synchronization

If you try to reuse and synchronize a very large number of items, a warning appears if it’s likely to impact performance.

If you still want to do this, consider reusing items in smaller batches or starting a large reuse and synchronize process during off hours when there is less competition for resources.

Review items

We recommend that reviews contain fewer than 250 items. This threshhold is in place to mitigate any performance issues that could come from a review with an excessive amount of items.