Managing Attachments - TestRail

Managing attachments

TestRail 7.1 introduces a Media Library for your attachments. This means that your attachments now become part of a library from which they can be easily reused in other test cases, runs, test results and even other projects.

To add an attachment to test cases, runs, plans, milestones, test results and defect pushes (where supported), you will see the following icons. TestRail supports uploading any type of file up to 256 MB in size.

To add an attachment, simply drag and drop anywhere you see either of the icons above to automatically attach the file without opening the media library, or click on ‘+’ icon to open the media library and browse your existing attachments or upload new attachments from your local filesystem.

Once you’ve opened the media library, there are four different ways to add a new attachment.

  1. Click on Add New at the top of the media library window to browse and select files from your local filesystem.
  2. Click the ‘+’  icon from within the media library.
  3. Drag and drop the file you want to attach anywhere inside the media library space.
  4. Select one of the attachments you’ve added previously from the media library by clicking the radio button in the in the top right-hand corner of the attachment thumbnail.

Once you have selected the files you would like to attach, click Attach to attach them.

Your attachments will be available throughout the current project. After uploading some you will see something like this:

To make the attachments available on other projects, see Attachment Details View.

Once you have a library of attachments, you can sort through them to find the attachments you need, by Date, Name or Size. Also, you can filter the attachments by File Type, Upload date, Created by, Case, Run, Plan and Milestone. You can also search for a specific attachment(s) by name.

Attachment Details View

Click on any attachment to open its detail view.

On this window you can change the name of the attachment to make it more easily searchable, if desired. You can also make the attachment accessible on other TestRail projects in your instance using the “Accessible in” input field. Simply start typing the name of the project you would like to share the attachment with, or click into the input area to open a dropdown of the other project names in your instance. You can also set visibility to All Projects from this drop-down.

Besides associated projects, the Attachment Details view gives you further information. Here you can:

  • View the file type, size and upload timestamp
  • View the unique URL for the attachment
  • Delete the attachment from your instance
  • Replace the attachment with a new one and keep the same name and URL
  • View the attachment at full resolution
  • Download the attachment

You now have the ability to refer to an attachment throughout TestRail, and update the referenced attachment in all places using the Replace function.

To learn more about managing attachments as a user with Administrator privileges, see the article on Data Management.