# Create an Issue

This page shows how to create an [issue](https://developers.google.com/issue-tracker/concepts/issues) in Google Issue
Tracker.

To create an issue, you must be signed in to a Google Account. You also must
have **Create Issues** or **Admin Components**
[permission](https://developers.google.com/issue-tracker/concepts/access-control) for the component where the issue will
be created. If you have **Comment on Issues** permission, you may set the issue
title and description only. If you have **Edit Issues** permission, you can set
other fields.

## Templates

Templates in Google Issue Tracker specify default values for fields in new
issues in a [component](https://developers.google.com/issue-tracker/concepts/components). Each component has a default
template but may have additional templates as configured by the Google employee
who is responsible for managing it. Public and partner users cannot create or
modify the templates associated with a component.

### Choose a template

When you [create an issue](https://developers.google.com/issue-tracker/guides/create-issue-ui) in Issue Tracker, the
default template for the component is automatically selected. If additional
templates are available, you can select them from the **Template** drop-down
list on the **Create Issue** page.

![](https://developers.google.com/issue-tracker/images/public/choose-template.png)

When you select a template, the fields in the page are automatically populated
with the default values defined.

## Create an issue

To create an issue:

1. [Open Issue Tracker](https://developers.google.com/issue-tracker/guides/access-ui) in your web browser.

2. Click **Create Issue**.

   Issue Tracker opens the **Create Issue** page and has the **Component**
   field selected. This field shows a drop-down list of components.

   ![](https://developers.google.com/issue-tracker/images/public/initial-component-drop-down.png)
3. Use the drop-down list to [find the component](https://developers.google.com/issue-tracker/guides/find-a-component) where you want to create
   the issue. You can only find components where you have **Create Issues** or
   **Admin Components** permission.

4. (Optional) Choose a [template](https://developers.google.com/issue-tracker/concepts/templates) that best applies to
   the issue you are reporting. Some components only have a default template.

   ![](https://developers.google.com/issue-tracker/images/public/choose-template.png)
5. Enter a [title](https://developers.google.com/issue-tracker/references/glossary-of-fields#title) in the **Title** field. The title is displayed when you
   view the details of the issue, as well as in search results, hotlists and
   other places where you are viewing lists of issues.

6. Select a [priority](https://developers.google.com/issue-tracker/references/glossary-of-fields#priority) from the **Priority** drop-down list. The
   **Priority** field is only visible if you have **Edit Issues** permission.

7. Select the issue [type](https://developers.google.com/issue-tracker/references/glossary-of-fields#type) from the **Type** drop-down list. The **Type**
   field is only visible if you have **Edit Issues** permission.

   ![](https://developers.google.com/issue-tracker/images/public/standard-fields.png)
8. (Optional) Designate an [assignee](https://developers.google.com/issue-tracker/references/glossary-of-fields#assignee) or add email addresses (including
   mailing list addresses) to the [Collaborators](https://developers.google.com/issue-tracker/references/glossary-of-fields#collaborators) and [CC](https://developers.google.com/issue-tracker/references/glossary-of-fields#cc) lists. These
   fields are only visible if you have **Edit Issues** permission.

   > [!NOTE]
   > Depending on your [email notification settings](https://developers.google.com/issue-tracker/guides/set-notification-preferences), you might need to add yourself to the CC list to receive notifications.

9. (Recommended) Enter a [description](https://developers.google.com/issue-tracker/references/glossary-of-fields#description) for the issue in the **Description**
   field. This field might already be partially populated for you if
   description text is provided by the selected template. You can also check
   the **Markdown** option to write the description as
   [markdown](https://commonmark.org) text.

10. (Optional) Add attachments from your computer or from a Drive location.

    ![](https://developers.google.com/issue-tracker/images/public/attachments.png)
11. (Optional) Fill in the advanced fields for the issue.

    You can view these fields by toggling the **Advanced fields** panel. The
    **Advanced fields** panel is only visible if you have **Edit Issues**
    permission. In most cases, you can skip advanced fields when creating an
    issue. However, some components require you to enter values for them. If
    this is the case, the **Advanced fields** section appears automatically, and
    the required fields are marked with an asterisk (\*).

    ![](https://developers.google.com/issue-tracker/images/public/toggle-advanced-fields.png)
12. Click the **Create** button to submit the issue or click **Create \& Start
    Another** to submit the issue and open a new **Create Issue** page
    pre-populated with the values used for the issue you just created.

    ![](https://developers.google.com/issue-tracker/images/public/create-start-another-buttons.png)

> [!TIP]
> Hover over the name of a field in the Create Issue page to view a field description.

## Create an issue based on an existing one

You can also create an issue based on an existing one. This method can save you
time by using the existing issue to pre-fill certain fields.

To create an issue based on an existing one:

1. Open the existing issue.

2. Click the button next to **Create**.

   ![The create issue button with the drop-down button highlighted](https://developers.google.com/issue-tracker/images/public/create-issue-button-with-menu-button.png)
3. Choose how you want to create the new issue from the drop-down list. The
   options in the drop-down list vary depending on the page that you are
   viewing. The button only becomes visible if there is at least one option
   available.

There are 7 possible options.

| Option | Description | Appears when |
|---|---|---|
| **In Same Component** | Starts a new issue with component set to the current component. | (1) Managing a component, (2) Viewing issues in a component, (3) Viewing an issue |
| **Similar To Current Issue** | Starts a new issue with the fields of the current issue copied to the new issue. | Viewing an issue |
| **Blocked By Current Issue** | Starts a new issue with the current issue as a blocking issue. | Viewing an issue |
| **Blocking Current Issue** | Starts a new issue with the current issue as a blocked issue. | Viewing an issue |
| **Parent Of Current Issue** | Starts a new issue with the current issue as a child issue. | Viewing an issue |
| **Child Of Current Issue** | Starts a new issue with the current issue as a parent issue. | Viewing an issue |
| **In Same Hotlist** | Starts a new issue with the current hotlist added to it. | (1) Managing a hotlist, (2) Viewing issues under a hotlist |

> [!CAUTION]
> The **Similar To Current Issue** option does not copy the changelist, duplicate issue ID, CC or reporter fields from the original issue.

## What's next

- [Learn more about issues](https://developers.google.com/issue-tracker/concepts/issues)
- [Learn more about components](https://developers.google.com/issue-tracker/concepts/components)
- [View and edit issues](https://developers.google.com/issue-tracker/guides/edit-issue-ui)