> For the complete documentation index, see [llms.txt](https://help.aristotlemetadata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aristotlemetadata.com/collaborating-within-the-registry/issues-and-change-requests/creating-an-issue.md).

# Creating an issue

Issues act as a platform that allows users to comment on, and propose changes to metadata items. Issues can be assigned a label, to better contextualise or identify them.

### How to create an issue

1. Select the 'Issues' tab from the desired metadata item page.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FR4rmQlce2sFCvv18z1Sg%2Fimage.png?alt=media&amp;token=eedd44c7-0c1f-4d3a-8a42-2acaa56cc0aa" alt=""><figcaption></figcaption></figure>

2. Select 'New Issue', then 'New Issue' from the dropdown.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FetMVR3REThpCxmXSg832%2Fimage.png?alt=media&amp;token=d1fb7203-9635-41dc-9346-d189f3b033be" alt=""><figcaption></figcaption></figure>

3. Populate the 'Title' and 'Description' fields as desired.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F3ifmySFKtMPxPVWHKbSw%2Fimage.png?alt=media&amp;token=a15854d7-760c-4abf-8186-bca908a64e05" alt=""><figcaption></figcaption></figure>

**Note:** The title (name) of the issue is shown in lists and notifications.

4. **If you wish to add labels to the item**, select those that apply from the 'Labels' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FML9aCedL050kGVMqHInk%2Fimage.png?alt=media&amp;token=1eca6a28-c9dd-4767-bc1e-06c95b6ba119" alt=""><figcaption></figcaption></figure>

**Notes:**

* If the item does not belong to a Stewardship Organisation, no labels will be available to choose from
* See [*Creating an issue label*](/collaborating-within-the-registry/issues-and-change-requests/creating-an-issue-label.md) if you need to create a label.

5. Select 'Create Issue'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FBxK5Ae9CMlL4OuM96gqy%2Fimage.png?alt=media&amp;token=a8f4db12-1bb8-49ae-a748-79d721587a54" alt=""><figcaption></figcaption></figure>
