Issue

Learn how to work with issues in Volta.

Issue

Overview

Volta's main goal is to provide a solution on top of GitHub issues. Issues and pull requests are tied to a repository and imported when you install our GitHub app.

Volta and GitHub are tightly integrated, everything you do on one will be reflected on the other. Volta provides most of GitHub features and simply brings its own touch on top of it.

Properties

You might be familiar with properties like comments, reactions, assignees, reviewers and labels from GitHub, here is what Volta adds:

Status

The status of an issue comes in addition of the GitHub state (open or closed) and is used to provide an automated issue board out of the box for your repositories.

Learn more on how Volta automatically updates issue status.

Milestones

You can attach project and repository milestones to an issue to organize and track progress.

Volta milestones are not synced with GitHub, learn more about them.

Due date

You can set a due date on an issue, which will be displayed in the board and list views in red when overdue and in orange when due within the week.

Tag

You can attach a repository tag to an issue in Done or Released status. This will automatically move the issue to Released if not already.

When a new tag is pushed to your repository, all issues in Done status will be automatically moved to Released status and linked to the tag.

History

When creating or editing an issue, selecting properties like repository, labels, assignees and reviewers will be saved in an history. Those properties will be sorted by most used next time you select them.

Actions

You can find issue actions in the menu:

  • Edit E
  • Archive
  • Duplicate
  • Subscribe
  • Sync with GitHub
  • Open on GitHub G
  • Copy reference
  • Copy link
  • Copy GitHub link
You can access all issue actions through the command menu K under Issue.

Archive

You can archived closed issues to hide them from the board, list and timeline views from the actions menu or by using the command menu action.

Subscribe

You can subscribe to an issue to receive notifications when new activities happen from the actions menu, by clicking on the button in the Activity section or by using the command menu action.

You will also find a subscribe menu in the Activity section where as a maintainer you can subscribe other users to the issue. This will send a Subscribe notification to the user.

Learn more about notifications on issues and pull requests.

Create

To create a new issue, you can click on the button in the sidebar. This button will open a modal where you can choose the repository you want to create the issue in. You can also use the command menu action or press C.

You will be able to select the status of the issue, a due date, labels, milestones and assignees. You can also add a title and a description using our markdown editor.

New issue

By default, you can select all repositories you're a maintainer of. On a project you can only select repositories of the project and on a repository you can select any repository from its organization.

Edit

To edit an issue, you can click on the button in the actions menu, use the command menu action or press E. You will enter edit mode and all your changes will be saved automatically in a draft. You can then save your changes by clicking on or by pressing S / Enter to update the issue.

Learn more about the draft system of our markdown editor.

You can also directly update the status, due date, tag, labels, milestones, assignees and reviewers of the issue without entering edit mode from the right panel.

You can update status, labels, milestones, assignees and reviewers through the command menu K by typing Change or through their respective shortcut S, L, M, A and R.

Views

When on a repository, project or user page, you can view issues in different ways.

You can switch between board, list and timeline views by clicking on the button in the header, by using the command menu action or by pressing the V shortcut to cycle through views.

You can display your timeline in split view on the board or list.

Search issues by typing in the input above the view. You can press F to focus the search input.

Learn how to use the search menu to find closed or archived issues.

Filters

Filter issues by almost any property by clicking on the button above the view.

You can also quickly filter by label by clicking on or badges for example.

Learn how to refine your issues with filters.