> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/issue-tracker/issues.md).

# Issues

The **Issues** page lets you create, view, edit, and manage issues for your organization.

### Create an Issue

1. In the left navigation panel, click **Issue Tracker → Issues**.
2. Click **Create New Issue** at the top-right corner of the page. The **Create Issue** dialog will appear.

   <figure><img src="/files/hwg3507jAaphWgIq1a1A" alt="" width="375"><figcaption></figcaption></figure>

   <sup>*UI under active update*</sup>
3. Fill in all **required fields** (Project, Issue Type, Summary, Status, Severity, Reporter).
4. *(Optional)* Expand **More Fields** to add details like Description, Assignee, Sprint, or Attachments.
5. Click **Create** to save. A confirmation toast will appear with a link to the new ticket.

{% hint style="info" %}
The system remembers your **last selected issue type**—the default type is **Task**.
{% endhint %}

***

### View or Edit Issues

* Update editable fields directly in the issue table (except metadata like *Created On*).

  <figure><img src="/files/iwsrgJQrk3cVLV2bW1OX" alt=""><figcaption></figcaption></figure>
* Click any **Issue ID** to open detailed information. Learn more in [Issue Details Page](https://testfirst-1.gitbook.io/testfirst/oUIL6bReuPgXhqU6cZVM/issue-tracker/issues#issue-details-page).
* Right-click an issue to open the context menu for quick actions:
  * **Copy Link** – Copy the issue link.
  * **Open** – View the issue details page.
  * **Delete** – Remove an issue (confirmation required).\
    ![](/files/5URRHJvt7TvrFD8wUroX)

#### Drag and Drop Issues

Drag issues up or down in the table to adjust their priority or order.

***

### Issue Details Page

1. Click an **Issue ID** from anywhere in the Issue Tracker - such as the **Summary**, **Sprints**, or **Issues** page.
2. The **Issue Details Page** will open, displaying all key information about the issue, including its status, severity, and activity.
3. Use this page to **review progress**, **add comments**, and **manage attachments** for collaboration and tracking.

{% hint style="info" %}
Use comments and attachments to keep discussions clear and centralized.
{% endhint %}

***

### Issue Tracker Email Notifications

Email alerts keep you updated on issue changes, assignments, and deletions.\
When multiple updates occur close together, they’re grouped into a single message.

You’ll receive notifications when:

* You’re assigned an issue.
* An issue you follow is updated.
* An issue is deleted.

***

### Permissions Required to Use the Issue Tracker

Access to the **Issue Tracker** is **permission-based**.\
Each action within the tracker requires specific permissions assigned to your role.

* **View Issues** - Required for all users to access and view issues in the tracker.
* **Manage Issues** - Allows users to create, edit, and delete issues.
* **Manage Sprints** - Allows users to create, edit, and delete sprints.

{% hint style="info" %}
All roles have basic *Create/Edit* access by default.\
Specific actions (like deleting sprints) require explicit permissions.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th></tr></thead><tbody><tr><td>To check your assigned role, visit the <strong>Users</strong> section under <strong>Administration</strong>.</td><td><a href="/spaces/ErSaU4WjIuLC7zfVEh8L/pages/QuHuGMHj51FnRGM4IBFI">/spaces/ErSaU4WjIuLC7zfVEh8L/pages/QuHuGMHj51FnRGM4IBFI</a></td></tr><tr><td>To update or review role permissions, see the <strong>Roles and Permissions</strong> section in Administration.</td><td><a href="/spaces/ErSaU4WjIuLC7zfVEh8L/pages/WlSj2F3SjTBfi6z2iJTl">/spaces/ErSaU4WjIuLC7zfVEh8L/pages/WlSj2F3SjTBfi6z2iJTl</a></td></tr></tbody></table>