Issues
Issues are the fundamental units of work in Axoria - they represent tasks, bugs, user stories, improvements, or any trackable item within a project.
Creating an Issue
- On the board or list, click + New Issue.
- Enter the title (required).
- Optionally set: type, priority, assignees, sprint, due date, and description.
- Click Create.
Each issue automatically receives a unique key in the format PROJECT-123.
Issue Types
Types allow you to categorize work. The following types are available by default (fully customizable):
| Type | Typical Use |
|---|---|
TASK |
Generic work item |
BUG |
A defect or problem to fix |
STORY |
A feature from the user's perspective |
EPIC |
A grouping of related stories |
SUBTASK |
A subdivision of a larger issue |
IMPROVEMENT |
An enhancement to something existing |
SPIKE |
Technical investigation or proof of concept |
RESEARCH |
Research and analysis without a direct code deliverable |
HOTFIX |
Urgent fix needed in production |
TECHNICAL_DEBT |
Technical debt to be addressed |
Configure at Settings → Issue Types.
Priorities
| Priority | Color | Meaning |
|---|---|---|
| Urgent | Red | Blocking work, requires immediate action |
| High | Orange | High importance, resolve soon |
| Medium | Yellow | Moderate importance |
| Low | Blue | Can wait |
| None | Gray | No priority set |
Configure at Settings → Priorities.
Assignees
An issue can have multiple assignees. To assign:
- Open the issue panel.
- Click Assignees and select the members.
Assignees receive notifications based on the project's notification rules.
Status and Workflow
An issue's status corresponds to the board column it is in. To change the status:
- Drag and drop the card in Kanban view
- Click the Status field in the issue panel and select the new status
Allowed transitions between statuses are configurable at Settings → Workflow.
Markdown Description
The issue description supports full Markdown:
**Bold**, *italic*, ~~strikethrough~~
- Bullet lists
1. Numbered lists
`inline code`
> Block quotes
| Table | With columns |
|-------|---------|
| data | value |
Code blocks with syntax highlighting are supported.
Story Points
Story Points represent the estimated effort for an issue, used in sprint planning.
In the issue panel, click the Story Points field and enter a whole number. Sprint totals and progress are displayed in the Timeline.
Issue Links
Issues can be linked to each other with different relationship types:
| Type | Description |
|---|---|
| Blocks | This issue must be resolved before the other |
| Is blocked by | Waiting on another issue to be resolved |
| Relates to | Conceptually related issues |
| Duplicates | This issue is a duplicate of another |
| Duplicated by | Another issue is a duplicate of this one |
To create a link: in the issue panel, go to Links → Add Link.
Time Tracking
Axoria lets you record the actual time spent on each issue.
Start Timer
In the issue panel, click ▶ Start to begin timing. The timer runs while you work.
Stop Timer
Click ⏹ Stop to end the session. Optionally add a description of the activity.
Only one active timer per user/issue is allowed. Starting again is idempotent.
Time Log
All time entries for the issue are listed in the panel. The accumulated total is shown in the summary.
The consolidated Time Report for the project is available in Reports.
Attachments
Issues support image file attachments.
Restrictions
- Only image files are accepted (PNG, JPG, GIF, WebP, etc.)
- Maximum size: 5 MB per file
- Maximum per issue: configurable in Settings → Attachments (default: 3; maximum: 20)
Uploading Attachments
In the issue panel, click 📎 Attach and select an image, or use drag and drop.
Attachments must be enabled in the project settings for upload to work.
Deleting an Issue
Issues can be deleted by project Managers. Deletion is permanent and removes all associated data (time entries, attachments, and links).