Jama Connect User Guide

Best practices and guardrails

Explorer Tree settings

To improve performance when your project has a large number of items, you can set 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 large numbers of items (more than 1,000 per folder), hide items in the Explorer Tree and work with them in List View in the center panel. To move multiple items, rather than multi-select in the Explorer Tree, multi-select in the List View and drag them to their new location in the Explorer Tree. 

Large files over 25 MB aren't indexed and therefore, their content isn't searchable. The following filetypes are indexable: PDF, DOC, DOCX, PPT, PPTX, TXT, RTF. The following filetypes aren't indexable: XLSX, XLS, XML, HTML, HTM.

Field content

Typically, item fields contain 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.