---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/milestone-work.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/milestone-work.md
  - href: en/sourcecraft/operations/milestone-work.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 milestones in SourceCraft

<!-- source: en/_includes/sourcecraft/milestone-description.md -->
_Milestones_ are a tool for planning and tracking key milestones during software development. 

Milestones may be associated with new releases or major updates.

For each milestone, you can set a due date and specify the [issues](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues) you need to complete to reach your target. You can also link [pull requests](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) to issues.

This way, by grouping milestones, issues, and pull requests, you can track development progress and manage priorities.
<!-- endsource: en/_includes/sourcecraft/milestone-description.md -->

## Creating a milestone {#create-milestone}

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 create a milestone in.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/sourcecraft/milestone.svg)</svg> **Milestones**.
1. In the top-right corner, click ![image](../../_assets/console-icons/plus.svg) **New milestone**.
1. In the window that opens, set the milestone properties:
    * **Title**.
    * **Start date** (optional setting).
    * **Due Date** (optional setting).
    * **Description** (optional setting).
1. Click **Create milestone**.

## Linking a milestone to an issue {#link-milestone}

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 where you want to link issues to a milestone.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/sourcecraft/milestone.svg)</svg> **Milestones**.
1. Select the milestone you want to link an issue to.
1. Under **Issues**, click **New linked item**.
1. Select the issue you want to link to the milestone from the drop-down list.

To link a milestone to another issue, under **Issues**, click ![image](../../_assets/console-icons/plus.svg) and select the issue.

To unlink an issue from a milestone, click ![image](../../_assets/console-icons/ellipsis.svg) next to the issue and select ![image](../../_assets/console-icons/link-slash.svg) **Unlink**.

## Viewing issues linked to a milestone {#view-issues}

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 where you want to view issues linked to a milestone.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/sourcecraft/milestone.svg)</svg> **Milestones**.
1. Click ![image](../../_assets/console-icons/ellipsis.svg) next to the milestone and select ![image](../../_assets/console-icons/arrow-up-right-from-square.svg) **Open on Issues page**.

## Editing or closing a milestone {#edit-milestone}

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 where you want to edit or close a milestone.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/sourcecraft/milestone.svg)</svg> **Milestones**.
1. Click ![image](../../_assets/console-icons/ellipsis.svg) next to the milestone and select ![image](../../_assets/console-icons/pencil.svg) **Edit**.
1. In the window that opens, edit the following milestone parameters:
    * **Title**.
    * **Start date**.
    * **Due Date**.
    * **Description**.

    To edit or close a milestone, select **Status**: **Closed**.
1. Click **Update milestone**.

## Deleting a milestone {#delete-milestone}

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 delete a milestone in.
1. Under ![image](../../_assets/console-icons/calendar.svg) **Plan** on the repository page, go to ![image](../../_assets/sourcecraft/milestone.svg)</svg> **Milestones**.
1. Click ![image](../../_assets/console-icons/ellipsis.svg) next to the milestone and select ![image](../../_assets/console-icons/trash-bin.svg) **Delete**.
1. Confirm the deletion.

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

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