Overview
The Xray Storage feature allows Xray administrators to efficiently and easily manage their storage resources for project attachments across different projects.
This feature also enables users to execute bulk actions seamlessly and intuitively filter and sort results, streamlining storage management tasks.
Storage handles the attachments of Xray entities based on your license terms. For further details on storage size specifications, please refer to the documentation here.
If your storage size limit needs to be upgraded please check more details at Xray Enterprise Storage.
Accessing and Using Storage
To access the Storage management screen, you must have permission to access the Jira global settings page (Figure 1 - 1).
On your Jira Cloud instance, click the Settings/gear icon button (Figure 1 - 1), and then select Apps (Figure 1 - 2).
A menu will open on the left side of the screen. Scroll down to Xray (Figure 1 - 3) and click Storage (Figure 1 - 4).
The Storage screen will open (Figure 2).
Here, you can:
- Click the Refresh Storage Usage button (Figure 2 - 4) to update your attachments' storage usage information.
- Click the Need more space? What you need to know (Figure 2 - 1) button to open a panel with information about the Storage limitations (a Cloud account is limited to 50 GB capacity; Xray Enterprise has a 3 TB limit, both applied only to Xray attachments).
- Click the Discover Enterprise Now button (Figure 2 - 2) and/or the Explore Enterprise Now button (Figure 2 - 9) to learn more about Xray Enterprise.
- View the list of projects, and their respective attachements' information (Figure 2 - 7).
- Use the search bar (Figure 2 - 6) to find attachments, and sort them by project, size, file format, and date of modification (Figure 2 - 8).
- Click the Actions button (Figure 2 - 13) to:
- Open entity (Figure 2 - 11).
- Delete the attachment (Figure 2 - 12).
Refreshing Storage Usage
The first time you access the Storage screen (Figure 2), your attachments list will be empty. So, the first thing to do is to click the Refresh Storage Usage button (Figure 2 - 4) to populate your attachments on the attachments list (Figure 2 - 7). Otherwise, you won't be able to see them listed (Figure 2 -7).
After clicking the Refresh Storage Usage button (Figure 2 - 4), a warning message is displayed indicating that this process can take a while, depending on the number of attachments on the instance. Once the operation is completed, the attachment list will be displayed (Figure 2 - 7).
After the refresh is complete, you will be able to see the current storage usage, by file type, together with the percentage and limit according to your license (Figure 2 - 5; 10).
Due to platform constraints and performance, the refresh option is time-gated not to allow multiple or single-user abuse of this feature.
The remaining time will be displayed until a new refresh is possible.
Searching and Filtering
To improve attachment management, on the attachments' list (Figure 2 - 7) you may use:
Search
A search bar (Figure 3 - 1) is provided to quickly search for an attachment's name. Write there the name of the attachment you want to find and press Enter to see the results matching your search (Figure 3 - 2).
Filters
Several filters are provided to narrow down the results (Figure 4).
Click each dropdown to see their usage options:
- Project (Figure 4 - 1) - find and select projects.
- Size (Figure 4 - 2) - filter by attachment size range.
- File format (Figure 4 - 3) - filter by file format grouped by types (Documents, Images, Videos, Other).
- Date modified (Figure 4 - 4) - filter by date modified (Today, Between, Within the last X Days/Weeks/Months/Years).
Actions
The Actions button (Figure 2 - 13) allows you to execute two operations:
Open Entity
When opening the entity (Figure 2 - 11), you can check the exact Xray Issue Type (Test, Test plan, Test Set, Test Execution) where the attachment is.
Delete Attachment(s)
There are two ways for you to remove attachments:
- Click the Delete button (Figure 2 - 12) to delete the corresponding attachment. This will open a modal for you to confirm the removal of that single attachment.
- Delete in bulk (Figure 5) - you can also delete several attachments at once by selecting them using the project selecting box (Figure 5 - 1). There, you can choose All, Current Space and/or None. You can also select multiple project attachments by checking the box on the corresponding project (Figure 5 - 2). Then, click the Actions button and select Delete (Figure 5 - 3). This will open a modal for you to confirm the removal of those attachments.
