---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/issue-work.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/issue-work.md
  - href: en/sourcecraft/operations/issue-work.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
title: Working with issues in SourceCraft
description: How to view, discuss, vote and comment on issues in SourceCraft and subscribe to notifications.
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt


# Working with issues in SourceCraft

<!-- source: en/_includes/sourcecraft/issue-description.md -->
_Issues_ is a tool for tracking bugs, improvements, and new feature requests within a project. In an issue, you can start a discussion in comments, set the job status, priority, and responsible employee.
<!-- endsource: en/_includes/sourcecraft/issue-description.md -->

<!-- source: en/_includes/sourcecraft/issue-work-video-link.md -->
See the video illustrating issue handling at [Creating an issue in a SourceCraft repository](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/issue-create.md).
<!-- endsource: en/_includes/sourcecraft/issue-work-video-link.md -->

## Joining a discussion on an issue {#activity}

<!-- source: en/_includes/sourcecraft/issue-activity-intro.md -->
You can use issues to maintain user activity in a project. Users may vote for an issue, discuss problems or ideas in comments, share their suggestions, and ask for clarifications. 

They can use reactions, e.g., likes, dislikes, and other emojis, to acknowledge a relevant or helpful comment. Users can mention each other in a message with the `@` symbol and add links to other issues, [milestones](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#milestones), and [pull requests](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) to group related discussions and resolve issues faster.

SourceCraft supports updating issue pages in real time. You do not need to refresh the page manually to see new comments, reactions, and other changes.
<!-- endsource: en/_includes/sourcecraft/issue-activity-intro.md -->

### Viewing an issue {#get-issue}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**.

    To view an issue in another user's repository, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories** on the ![image](../../_assets/console-icons/planet-earth.svg) **Discover** tab.

1. Select the repository with the issue you want to join a discussion on.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/console-icons/file-text.svg) **Issues**.

    <!-- source: en/_includes/sourcecraft/issue-filter.md -->
    {% note info %}

    The issue list page supports the following filters:
    * **Status**
    * **Priority**
    * **Assignee**
    * **Author**
    * **Labels**
    * **Milestone**
    * **Title**

    You can sort issues by the following parameters:
    * **Date created**
    * **Date updated**
    * **Votes**

    {% endnote %}
    <!-- endsource: en/_includes/sourcecraft/issue-filter.md -->

1. Select the issue you want to join a discussion on.

    <!-- source: en/_includes/sourcecraft/issue-open-type.md -->
    By default, issues open in a pop-up panel to the right of the issue list. To navigate to a new window, click ![image](../../_assets/console-icons/arrow-up-right-from-square.svg) in the top-right corner. To instantly open an issue in a new window, click it while holding down **Command** in macOS or **Ctrl** in Windows or Linux.

    {% note tip %}

    You can [change](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/interface-settings.md#issue-open-mode) the default issue display behavior in the interface settings.

    {% endnote %}

    The issue displays statuses of its associated [pull requests](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr), including information about target branch merge failures.
    <!-- endsource: en/_includes/sourcecraft/issue-open-type.md -->

### Voting for an issue {#vote-issue}

In the top-right corner of the issue page, click ![image](../../_assets/console-icons/thumbs-up.svg) **Vote**.

You can revoke your vote at any time by clicking the same button.

### Leaving a comment {#comment-issue}

On the issue page under **Activity**, enter your comment and click **Comment**.

When commenting, you can use [Yandex Flavored Markdown](https://diplodoc.com/docs/en/index-yfm), attach files, add emojis, and mention users with `@`.

<!-- source: en/_includes/sourcecraft/issue-pr-comment-parsing.md -->
Descriptions and comments to [issues](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues) and [pull requests](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) support short links to other issues and pull requests. Such entries automatically convert into hyperlinks that display a summary preview card on hover. Use the following formats:
* `!<pull_request_number>`: Pull request in the current repository.
* `<repository_slug>!<pull_request_number>`: Pull request in a different repository of the current organization.
* `<organization_slug>/<repository_slug>!<pull_request_number>`: Pull request in the specified organization and repository.
* `#<issue_number>`: Issue in the current repository.
* `<repository_slug>#<issue_number>`: Issue in the a different repository of the current organization.
* `<organization_slug>/<repository_slug>#<issue_number>`: Issue in the specified organization and repository.
<!-- endsource: en/_includes/sourcecraft/issue-pr-comment-parsing.md -->

<!-- source: en/_includes/sourcecraft/create-issue-from-comment.md -->
{% note tip %}

You can create a new issue from a comment to a [pull request](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) or [issue](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues) by clicking ![image](../../_assets/console-icons/ellipsis.svg) next to the comment and selecting ![image](../../_assets/console-icons/arrow-up-right-from-square.svg) **Create issue**.

{% endnote %}
<!-- endsource: en/_includes/sourcecraft/create-issue-from-comment.md -->

To edit your comment, click ![image](../../_assets/console-icons/ellipsis.svg) in its top-right corner and select ![image](../../_assets/console-icons/pencil.svg) **Edit**.

To delete your comment, click ![image](../../_assets/console-icons/ellipsis.svg) in its top-right corner and select ![image](../../_assets/console-icons/trash-bin.svg) **Delete**.

### Replying to a user {#reply-issue}

1. In the top-right corner of the comment, click ![image](../../_assets/console-icons/arrow-uturn-ccw-left.svg).
1. Type your reply in the field that appears and click **Comment**.

### Reacting to a comment {#reaction}

In the top-right corner of the comment, click ![image](../../_assets/console-icons/face-smile.svg) and select an emoji.

## Subscribing to notifications for an issue {#notifications}

<!-- source: en/_includes/sourcecraft/issue-notifications-intro.md -->
To stay updated on new comments, reactions, and other events, subscribe to notifications for the issue. You will be getting these at the email linked to your account.
<!-- endsource: en/_includes/sourcecraft/issue-notifications-intro.md -->

You will get issue notifications by default only if you are mentioned in a comment with `@`.

To subscribe to all issue notifications, click ![image](../../_assets/console-icons/bell.svg) ![image](../../_assets/console-icons/chevron-down.svg) in the top-right corner of the issue page and select **Subscribe**.

To unsubscribe from all issue notifications, click ![image](../../_assets/console-icons/bell.svg) ![image](../../_assets/console-icons/chevron-down.svg) in the top-right corner of the issue page and select **Unsubscribe**.

## Editing an issue {#edit-issue}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**.
1. Select the repository you want to edit an issue in.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/console-icons/file-text.svg) **Issues**.

    <!-- source: en/_includes/sourcecraft/issue-filter.md -->
    {% note info %}

    The issue list page supports the following filters:
    * **Status**
    * **Priority**
    * **Assignee**
    * **Author**
    * **Labels**
    * **Milestone**
    * **Title**

    You can sort issues by the following parameters:
    * **Date created**
    * **Date updated**
    * **Votes**

    {% endnote %}
    <!-- endsource: en/_includes/sourcecraft/issue-filter.md -->

1. Select the issue you want to edit.
1. Edit its settings:

    <!-- source: en/_includes/sourcecraft/issue-settings.md -->
    * Enter a name for the issue.
    * Optionally, provide a detailed description of the issue or an idea for a new feature.

      <!-- source: en/_includes/sourcecraft/issue-pr-comment-parsing.md -->
      Descriptions and comments to [issues](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues) and [pull requests](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) support short links to other issues and pull requests. Such entries automatically convert into hyperlinks that display a summary preview card on hover. Use the following formats:
      * `!<pull_request_number>`: Pull request in the current repository.
      * `<repository_slug>!<pull_request_number>`: Pull request in a different repository of the current organization.
      * `<organization_slug>/<repository_slug>!<pull_request_number>`: Pull request in the specified organization and repository.
      * `#<issue_number>`: Issue in the current repository.
      * `<repository_slug>#<issue_number>`: Issue in the a different repository of the current organization.
      * `<organization_slug>/<repository_slug>#<issue_number>`: Issue in the specified organization and repository.
      <!-- endsource: en/_includes/sourcecraft/issue-pr-comment-parsing.md -->

    * Optionally, attach additional files.
    * Under **Priority**, set priority:
      * ![image](../../_assets/console-icons/chevrons-down-wide.svg) **Trivial**: Trivial
      * ![image](../../_assets/console-icons/chevron-down-wide.svg) **Minor**: Minor
      * ![image](../../_assets/console-icons/equal.svg) **Normal**: Regular
      * ![image](../../_assets/console-icons/chevrons-up-wide.svg) **Critical**: Critical
      * ![image](../../_assets/console-icons/ban.svg) **Blocker**: Blocker
    * Under **Visibility**, select issue access type:
      * **Private**: The issue can be accessed only by you.
      * **Public**: The issue can be accessed by any user with access to the repository.

        {% note info %}

        You can change the access level at any time.

        {% endnote %}

    * Optionally, under **Assignee**, select the user responsible for the issue.
    * Optionally, under **Labels**, select the labels for the issue. 
          
      You can select existing labels from the list or create a new one. 
          
      To set the label color, click it and select the color from the drop-down list.
    * Optionally, under **Milestone**, select a [milestone](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#milestones) to link the issue with.
    <!-- endsource: en/_includes/sourcecraft/issue-settings.md -->

1. To link the issue to other issues, click ![image](../../_assets/console-icons/link.svg) **Link issue**.

    <!-- source: en/_includes/sourcecraft/issue-connection.md -->
    {% note tip %}

    You can link issues from different [repositories](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#repos) within one [organization](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#org). The following link types are available: ![image](../../_assets/console-icons/link.svg) **Related issue**, ![image](../../_assets/console-icons/circle-arrow-right.svg) **Sub-issue**, ![image](../../_assets/console-icons/folder-arrow-up-in.svg) **Parent issue**, ![image](../../_assets/console-icons/octagon-xmark.svg) **Blocker for**, ![image](../../_assets/console-icons/shuffle.svg) **Blocked by**, and ![image](../../_assets/console-icons/copy-transparent.svg) **Duplicate of**.

    {% endnote %}

    You can select an existing issue from the drop-down list or create a new one directly on the current page.
    <!-- endsource: en/_includes/sourcecraft/issue-connection.md -->

1. To link the issue to a pull request, click ![image](../../_assets/console-icons/link.svg) **Link pull request**.

## Adding labels {#add-labels}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**.
1. Select a repository.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/console-icons/file-text.svg) **Issues**.
1. Select an issue.
1. In the right-hand panel, under **Labels**, add [labels](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#labels).

## Searching for an issue by label {#search-label}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**.
1. Select a repository.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/console-icons/file-text.svg) **Issues**.
1. In the search bar, select `Labels`, a condition, and enter the label name.

## Adding labels {#add-labels}

1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the ![image](../../_assets/console-icons/house.svg) **Home** tab, under ![image](../../_assets/console-icons/layout-tabs.svg) **Your craftspace**, navigate to ![image](../../_assets/console-icons/archive.svg) **Repositories**.
1. Select a repository.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/console-icons/file-text.svg) **Issues**.
1. Select an issue.
1. In the right-hand panel, under **Labels**, add [labels](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#labels).

#### Useful links {#see-also}

* [Creating an issue in a SourceCraft repository](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/issue-create.md)
* [Working with an issue board in a SourceCraft repository](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/board-control.md)
* [Working with milestones in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/milestone-work.md) 
* [SourceCraft resource relationships](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md)