Issues

Issues track bugs, feature requests, and discussion for a repository. Each repository has its own issue tracker at /<namespace>/<repo>/-/issues.

Creating an Issue

1. Open a repository and go to the Issues tab
2. Click New issue (you must be signed in)
3. Enter a title (required)
4. Write an optional description in the Markdown editor. Use the toolbar for headings, bold, italic, inline code, code blocks, links, lists, task lists, and quotes, and switch to the Preview tab to see the rendered result
5. Attach files by pasting, dropping, or clicking the attachment area. Images, PDFs, and archives up to 10 MB each (max 10 files) are inserted into the description as Markdown links
6. Optionally pick an assignee and apply labels from the sidebar. The repository owner and its collaborators are available as assignees
7. Click Create issue

If the repository has no labels yet, create them first under Repository → Labels.

Issue Numbers

Every issue gets an iid — a per-repository sequence number shown as #1, #2, and so on. The iid is unique within the repository and appears in the issue URL: /<namespace>/<repo>/-/issues/<iid>.

Open and Closed States

An issue is either opened or closed. New issues start opened. On the issue page, use the Close button to close it; once closed, the button becomes Reopen. Closing and reopening are recorded as activity events and dispatched to webhooks.

Comments

Signed-in users can leave comments at the bottom of an issue. Comments support the same Markdown rendering as descriptions, and commit SHAs are automatically linked. New and edited comments appear in real time for anyone viewing the issue.

You can edit your own comments (and your own issue's title and description) using the Edit button — only the author may edit.

Assignees and Labels

Assignee and labels can be changed at any time from the sidebar on the issue page; updates apply immediately. Filtering on the issue list relies on labels, so applying labels keeps the tracker organized.

Filtering the Issue List

The Issues tab lets you narrow what's shown:

• State tabs — switch between Open, Closed, and All. The Open and Closed tabs show counts
• Label filter — when the repository has labels, pick one from the dropdown to show only issues carrying that label

Issues are listed newest first, ordered by descending issue number.

AI Fixes

If you have an AI provider key configured, open issues show a Fix with AI button. This dispatches an AI job that attempts a fix and opens a merge request. See the AI Assistant page for details.

Issue Boards provide a kanban-style view of issues grouped by label — see Issue Boards.