---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/board-control.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/board-control.md
  - href: en/sourcecraft/operations/board-control.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt

# Working with an issue board in a SourceCraft repository

You can use _boards_ to work with [issues](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues). Boards allow you to track progress and manage issue statuses.

<!-- 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 -->

<!-- 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 -->

<!-- source: en/_includes/sourcecraft/boards-description.md -->
Issues on the board are distributed between columns and sorted by creation date. Columns correspond to issue statuses:

* ![image](../../_assets/console-icons/circle.svg) **Open**
* ![image](../../_assets/console-icons/circle-play.svg) **In progress**
* ![image](../../_assets/console-icons/circle-pause.svg) **Paused**
* ![image](../../_assets/console-icons/circle-xmark.svg) **Declined**
* ![image](../../_assets/console-icons/circle-check.svg) **Closed**

Each issue card contains:

* Assignee's avatar. Hover over the avatar for the username and a link to the profile.
* Issue priority icon. Hover over this icon to see the priority name.
* Issue number.
* The ![image](../../_assets/console-icons/link.svg) icon to copy a link to the issue. Hover over the card to see this icon.
* Issue name.
* List of tags.
* [Milestone](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#milestones) name. Hover over the milestone name to view the deadline and open the milestone.
<!-- endsource: en/_includes/sourcecraft/boards-description.md -->

## Enabling board mode {#board-view}

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 ![image](../../_assets/console-icons/layout-split-columns.svg) **Board** on top.

Minimize the panels on the left to have more workspace by clicking ![image](../../_assets/console-icons/triangle-left-fill.svg) in the bottom part of the panel.


## Creating an issue {#issue-create}

1. [Enable](#board-view) board mode.
1. In the ![image](../../_assets/console-icons/circle.svg) **Open** column header, click ![image](../../_assets/console-icons/plus.svg).
1. On the panel that opens, enter the issue name and click **Create issue**.


## Opening an issue {#issue-open}

1. [Enable](#board-view) board mode.
1. Click the relevant issue card.

<!-- 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 -->

## Changing issue status {#issue-status-change}

1. [Enable](#board-view) board mode.
1. Click and hold the issue card and drop it to the relevant column.

This will change the issue status.

The ![image](../../_assets/console-icons/circle-xmark.svg) **Declined** and ![image](../../_assets/console-icons/circle-check.svg) **Closed** issues are not displayed by default. To view them, change the filter configurations in the top part of the page.

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

* [Working with issues in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/issue-work.md)
* [Creating an issue in a SourceCraft repository](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/issue-create.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)