YouTrack Server 2023.3 Help

Attach Files

You can attach files directly to an issue or in a comment. You can upload and attach images and other file types. The option to attach a file to an issue is displayed in the issue toolbar in the list view and single issue view.

When you attach a file from the Issues list, the attachment is added to the currently highlighted issue in the list.

Files can be attached directly to the issue or added with a comment.

  • When attached to the issue, the files only appear in the Attachments section of the page.

  • Files that are attached to comments are shown in the Attachments section of the issue and are also displayed as thumbnails directly under the comment text.

The instructions on this page describe how to attach files directly to an issue. To learn more about attaching files to comments, see Attach Files to Comments.

To attach a file to an issue:

  1. Click the Show more button in the issue toolbar.

  2. Select one of the following options:

    Option

    Description

    Attach files

    Opens a dialog where you can locate and upload files from your local directory. The attachments inherit the visibility setting from the issue.

    For more information, see Visibility for Attachments.

    Attach files privately

    Opens a dialog where you can select one or more files and restrict the visibility of the attachments to a specific group. Use this option when the files contain sensitive information like user accounts or log files.

    Attach and edit image

    Opens a dialog where you can select, drop, or paste an image from the clipboard. The file opens in the Image Editor. The Image Editor lets you apply various effects and add comments to the image. You can also set the visibility group directly in the dialog. For more information, see Edit Images.

To attach a file to an issue:

  • There are two ways to attach a file to an issue:

    1. Drag one or more files anywhere over the middle of the page.

    2. From the Show more menu, select one of the following options:

      Option

      Description

      Attach files

      Opens a dialog where you can locate and upload files from your local directory. The attachments inherit the visibility setting from the issue.

      For more information, see Visibility for Attachments.

      Attach files privately

      Opens a dialog where you can select one or more files and restrict the visibility of the attachments to a specific group. Use this option when the files contain sensitive information like user accounts or log files.

Keyboard Shortcuts

You can use keyboard shortcuts to attach files to an issue. These shortcuts are available in the list view and single issue view.

Windows Shortcut

Mac Shortcut

Description

Ctrl + Alt + A

Control + Option + A

Opens a dialog where you can locate and upload a file from your local directory. The attachment inherits the visibility setting from the issue.

Ctrl + V

+ V

Attach an image from the clipboard to the issue or comment.

Ctrl + Alt + Shift + V

Control + Option + Shift + V

Opens a dialog to attach and set visibility for files.

Drag and Drop

You can attach a file simply by dragging it to an issue. You can drag and drop multiple files and attach them all at once.

Open an issue in quick view or single issue view, then drag one or more files to the drop zone.

Drag attachments single issue view

This method works in any view mode.

  • In the Issues list, drag one or more files to the target issue in the list.

    Drag attachment to list view
  • In single issue view, drag one or more files anywhere over the middle of the page.

    Drag attachments single issue view

Paste

You can copy a file to your clipboard and paste it as an attachment to an issue. This method uses the standard keyboard paste command Ctrl + V ( + V for macOS).

In list and single issue view, the pasted file is attached to the issue. You can also paste an image directly into a comment.

View Attachments

All the files that are attached to an issue are shown as thumbnails. YouTrack provides different levels of interaction based on the type of file that is represented by the thumbnail.

File Type

Behavior

Image

For image files, the thumbnail contains a preview of the image.

  • Move your pointer over the thumbnail to display a larger version of the image preview.

  • Click the thumbnail to open the image in lightbox mode.

  • Click the View text icon to open the text view and work with the text recognized in the image. For more information, see Text Recognition.

You can also display attached images inline with the body of the issue description or comment text using Markdown. For more information, see Image Attachments.

Video

For video files in MPEG-4, Ogg, and WebM format, clicking the thumbnail opens and plays the video in a new browser tab.

You also have the option to embed video files in these formats into the issue description or comment text using Markdown. For more information, see Embedded Videos.

Download Attachments

You can download any attachment to your local directory by clicking the Download icon on the attachment thumbnail.

Download an attachment.

For all file types except images and video files, clicking the thumbnail downloads a copy of the file to your local directory.

In YouTrack Classic, you can also download all attachments at once by selecting the Download all option from the Attachments menu. This option is not yet available in YouTrack Lite.

Download all attachments.

Hide the Attachments Panel

An additional control lets you collapse the Attachments panel. This can be especially handy for issues that contain a large number of screenshots or other attachments.

Use this control to hide the thumbnails, so you can follow the thread between the issue description and the comments section below.

Control that collapses the Attachments panel in an issue.
Control that collapses the Attachments panel in an issue.

Edit or Remove an Attachment

You can update the file name and change the visibility of an issue at any time.

To edit an attachment:

  1. Open the issue in quick view or single issue view.

  2. Click the edit icon next to the attachment that you want to update.

    Edit attachment
    • If the attachment is an image, the file opens in the Image Editor. For more information, see Edit Images.

    • If the attachment is not an image, the Edit Attachment dialog opens.

      Edit attachment dialog
  3. Use the following options to update the attachment properties:

    Option

    Description

    New name

    Change the name of the file.

    Visible to

    Select a group to change the visibility setting for the attachment.

    Cancel

    Discard changes and close the dialog.

  4. Click the Save button to apply your changes and close the dialog.

You can remove an attachment from an issue by clicking the delete attachment icon in quick view or single issue view.

To edit an attachment:

  1. Open the issue in single issue view.

  2. Click the edit icon next to the attachment that you want to update.

    Edit attachment
    • If the attachment is an image, the file opens in the Image Editor. For more information, see Edit Images.

    • If the attachment is not an image, the Edit Attachment dialog opens.

      Edit attachment dialog
  3. Use the following options to update the attachment properties:

    Option

    Description

    New name

    Change the name of the file.

    Visible to

    Select a group to change the visibility setting for the attachment.

    Cancel

    Discard changes and close the dialog.

  4. Click the Save button to apply your changes and close the dialog.

You can remove an attachment from an issue by clicking the delete attachment icon in single issue view or deleting the attachment in the Edit Attachment dialog as described above.

YouTrack lets you generate direct links to attachments. These links allow anyone who is sent the link to access the file. For security reasons, links that are generated and shared manually expire after three days.

Every file attached to an issue is assigned a web address. If this address is accessible from outside your local network, it can be shared with people who wouldn't otherwise have access to files that are stored in your YouTrack installation. If authorized users generate and share these links, anyone who follows this link has unrestricted access to the information that is stored in the attachment.

Direct links to issue attachments in YouTrack are generated in these situations:

  • Any user who has access to view attachments in an issue can copy the link address for a file attachment and share this URL online.

  • In notifications, attachment references are converted into links automatically. These notifications and the links they contain can be shared with a broader audience.

  • In projects that use the Mailbox integration, attachment links are generated when files are attached to comments that are converted into email replies. Unregistered users who receive links to files in these email messages can post the URL that points to the attachment wherever they want or forward the email that contains the links.

To simplify access, direct links to file attachments contain a signature. This signature grants access to the file based on the permissions that are available to the user who attached the file to the issue. This gives users direct access to these files without having to log in to YouTrack. YouTrack supports this behavior for the following reasons:

  • In projects that use the Mailbox integration, this lets email recipients open links to files even when they don't have a registered account in YouTrack.

  • For notifications, users can conveniently view attachments even when they don't have an active YouTrack session in the browser. It also means that image attachments can be reliably embedded into email messages.

To reduce the accidental oversharing of sensitive information through attachment links, the signatures are generated in the following ways:

  • URL signing involves two secrets, one user-specific and one file-specific. This means that a URL signature will only work for a particular file.

  • The signed URL contains information about the user who created it. YouTrack checks the current permissions for this user every time the data is accessed, no matter who requests to access the file.

  • When the user who attached the files loses permission to access the issue or comment, the generated links become invalid and no longer work.

  • Signatures in links that are generated online expire after three days.

  • Signatures in links that are generated for notifications and workflow messages expire after two weeks.

If you encounter a situation where a user has attached a file that contains sensitive information, and you believe that the link may be accessible to unauthorized users, you can invalidate the link as follows:

  • Restrict the visibility of the issue or comment to exclude the user who attached the file or files.

  • Delete the files from the issue.

  1. Open the YouTrack issue with the attachment you want to share.

  2. In the Activity Stream, display the Issue history.

  3. Locate and right-click the link to the attachment you want to share.

  4. Select Copy Link Address.

    Link to issue attachment
    • The attachment link address has been copied to your clipboard.

    • If this address is accessible from outside your local network, it can be shared with people who wouldn't otherwise have access to files that are stored in your YouTrack installation.

    • If you generate and share a link, anyone who follows this link has unrestricted access to the information that is stored in the attachment.

Text in Image Attachments

YouTrack comes with a built-in optical character recognition (OCR) service that lets you work with text from image attachments. With the text recognition feature activated, you can view and copy the text found in image attachments. To learn how to activate and use this feature, see Text Recognition.

When YouTrack has finished processing an image and found text, the View text icon appears on the image thumbnail in the attachment preview.

The text recognition icon
The text recognition icon

The View text icon is also shown on the inline images.

The text recognition icon on an inline image
The text recognition icon on an inline image

When you click the View text icon, the text view opens. Here, you can view, select, and copy the text recognized from the image.

Text view

You can also search for issues and articles with images containing specific text using the attachment text search attribute or its alias image text.

Sample search query: attachment text: sample text

For details about the related search attributes, see attachment text.

Last modified: 22 March 2024