---
title: Add Files to an Artifact
slug: rm/add-files-to-an-artifact
docTags: 
createdAt: 2026-06-09T13:38:45.758Z
---

The Files tab in the Utility Panel allows you to view, add, and delete file attachments and document references for the selected artifact.

Not all file types may be available. Instance Administrators can specify the types of files that can be uploaded to Blueprint by whitelisting certain uploadable file types in a specific project or instance.

:::hint{type="info"}
The Files tab is not visible for Document artifacts as file attachments for that artifact type are viewed and managed in the main content area.
:::

# Add an Attachment to an Artifact

File attachments are unique to that artifact, and are used when no other artifacts will require the file that is being attached. Any type of files can be attached.

To attach a file to a selected artifact:

1. Click **Add Attachment** under the Files tab in the Utility Panel if there are no attachments or document references already added to the artifact.Click the **Add New** menu and select **Attachment** if there is already an attachment or document reference added to the artifact.

   ::Image[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173364431/add-attachment-1.png" size="40" isUploading="false" width="284" height="536" darkWidth="284" darkHeight="536" position="flex-start" showCaption="false"}

   ::Image[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173372034/add-attachment-2.png" size="40" isUploading="false" width="284" height="454" darkWidth="284" darkHeight="454" position="flex-start" showCaption="false"}
2. In your file manager, select the file you want to attach.
3. The file is displayed under the Files tab in the Utility Panel.
   To open a file, click its download icon (:inlineImage[]{src="https://files.helpdocs.io/4rdnduk17o/other/1571156159008/preview-ico.png" alt caption width="18" height="16"}). To delete it, click the delete icon (:inlineImage[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173402098/attachment-delete.png" alt caption width="12" height="15"}).
   If the attached file is an image, you and other users can preview it by clicking the preview icon (:inlineImage[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173395319/attachment-download.png" alt caption width="14" height="15"}).

# Add a Document Reference to an Artifact

Document references are used to link already existing document artifacts. It is useful to create document artifacts that contain important information that other artifacts will need as a reference.

1. Click **Add Reference** under the Files tab in the Utility Panel if there are no attachments or document references already added to the artifact.Click the **Add New** menu and select **Document Reference** if there is already an attachment or document reference added to the artifact.

   ::Image[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173412707/add-file-1.png" size="40" isUploading="false" width="284" height="536" darkWidth="284" darkHeight="536" position="flex-start" showCaption="false"}

   ::Image[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173420295/add-file-2.png" size="40" isUploading="false" width="284" height="454" darkWidth="284" darkHeight="454" position="flex-start" showCaption="false"}
2. In the Add Document Reference modal, search for and select the document artifact in the project you want to add a document reference to, and then click **OK**.

   ::Image[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173433116/add-file-3.png" size="70" isUploading="false" width="502" height="437" darkWidth="502" darkHeight="437" position="flex-start" showCaption="false"}
3. The document reference is displayed under the Files tab in the Utility Panel.

To download the document, click its download icon (:inlineImage[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173441234/attachment-download.png" alt caption width="14" height="15"}).

To delete the document reference, click the delete icon (:inlineImage[]{src="https://files.helpdocs.io/4rdnduk17o/other/1567173447421/attachment-delete.png" alt caption width="12" height="15"}).

To navigate to the document artifact that has been referenced, click the document name.