This page shows how to perform common tasks with
[hotlists](https://developers.google.com/issue-tracker/concepts/hotlists) in Google Issue Tracker.

## Create a hotlist

When you create a hotlist, you are granted **Admin** permission and it is
private to you by default. You must change the [permissions](https://developers.google.com/issue-tracker/guides/work-with-hotlist#permissions) on
the hotlist in order for it to be visible to or modifiable by other users.

To create a hotlist:

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

2. Click **Create hotlist**, located near the bottom of the
   left-hand navigation.

   ![](https://developers.google.com/issue-tracker/images/public/create-hotlist-highlight.png)

   The **Create a new hotlist** window appears.
3. Enter a name for the hotlist.

4. (Optional) Enter a description for the hotlist.

5. Click **Save**.

   The hotlist appears in the left-hand navigation in the **Hotlists** section.

You can also create a hotlist with the
[hotlist picker](https://developers.google.com/issue-tracker/concepts/hotlists#picker) found on an issue page
or in a bulk edit, or from the
[Manage hotlists](https://developers.google.com/issue-tracker/concepts/hotlists#manage-hotlists-page) page.

## Edit a hotlist

You must have **Admin** permission for the hotlist in order to edit its
properties. You have **Admin** permission for hotlists you create.

To edit a hotlist:

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

2. In the left-hand navigation, find the hotlist you want to edit.

3. Hover over the hotlist and click the "more" button.

4. Select **Settings**.

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

   The hotlist details window appears.
5. On the settings page, you can rename the hotlist, add to or modify the
   description, or change the [access control settings](https://developers.google.com/issue-tracker/guides/work-with-hotlist#permissions).

6. Click **Save**.

You can also edit a hotlist from its page of issues by clicking the edit
(pencil) icon next to the hotlist name.

## Star a hotlist

You can identify important hotlists by starring them. Starred hotlists will also
appear in the hotlist picker when [adding or removing
hotlists](https://developers.google.com/issue-tracker/guides/work-with-hotlist#add-issue) from an issue.

> [!NOTE]
> **Note:** Hotlists that you own are starred automatically.

To star a hotlist:

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

2. In the left-hand navigation, select the hotlist you want to star.

3. At the top of the page, click the "star" icon next to the hotlist name.

## Add and remove issues

You must have **Admin** or **View and append** permissions on a hotlist to add
or remove issues.

To add or remove issues in a hotlist:

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

2. Check the issue that you want to add or remove, or open the issue.

3. Click the **Hotlists** button in the top bar to open the
   [Hotlist picker](https://developers.google.com/issue-tracker/concepts/hotlists#picker).

4. To add the issue to a hotlist, check the box next to that hotlist and click
   **Save** . To remove the issue from a hotlist, clear the checkbox and click
   **Remove**. Multiple hotlists can be added or removed in the same action.

   > [!NOTE]
   > **Note:** If you don't see the hotlist you want, you may need to star it. See [Star a hotlist](https://developers.google.com/issue-tracker/guides/work-with-hotlist#star) for more information.

You can also use a hotlist picker to simultaneously add or remove multiple
issues to or from a hotlist during a [bulk edit](https://developers.google.com/issue-tracker/guides/edit-issue-bulk).

## Set hotlist permissions

You must have **Admin** permission for the hotlist in order to set permissions
for other users and groups.

To set [permissions](https://developers.google.com/issue-tracker/concepts/access-control#hotlists) for a hotlist:

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

2. In the left-hand navigation, find the hotlist where you want to change
   permissions.

3. Hover over the hotlist and click the drop-down button.

4. Select **Settings**.

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

   The hotlist details window appears.
5. Click the **Access Control** tab and grant permissions for the hotlist as
   required.

6. Click **Update**.

Any user or group granted permissions to the hotlist must have a Google Account.
Otherwise, the user will be indicated with a red border and an error message
will display **Invalid user(s)**.

## Add a hotlist to navigation

You must have **Admin** , **View and append** or **View only** permission on the
hotlist in order to add it to the left-hand navigation.

To add a hotlist:

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

2. Click the magnifying glass icon next to **Hotlists** in the left-hand
   navigation.

   ![](https://developers.google.com/issue-tracker/images/public/hotlist-magnify-highlight.png)
3. Where prompted, search for the hotlist by keywords in its name or
   description. You can only search for hotlists where you have **Admin** ,
   **View and append** , or **View only** permission.

   You can also use `owner:[NAME]` to search by the name of a user who has
   **Admin** permission on it.
4. To add a hotlist to the **Hotlists** section of the left-hand navigation,
   click the star next to the search result.

   ![](https://developers.google.com/issue-tracker/images/public/hotlist-search-star.png)
5. To view the list of issues in a hotlist, click the search result.

   You can also add the hotlist from the issues page by clicking the star icon
   located to the left of the hotlist name.

## Remove a hotlist from navigation

If you are not the owner of a hotlist, you can remove it from the navigation by
unstarring it. If you are the owner, you can remove it by archiving it.

To remove a hotlist from the navigation.

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

2. Find the hotlist you want to remove in the left-hand navigation and open it.

3. To the left of the hotlist name, click **Un-star this hotlist**.

4. If you are the hotlist owner or if you have **Admin** permission on the
   hotlist:

   1. Hover over the hotlist and click the "more" icon.

   2. Select **Settings**.

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

      The hotlist details window appears.
   3. Click the **Archive** button in the top bar.

   4. Click **Confirm**. This archives the hotlist for all users who had
      access to it.

Archived hotlists no longer appear on the left-hand navigation and no longer
appear as chips on issue pages.

## What's next

- [Learn more about hotlists](https://developers.google.com/issue-tracker/concepts/hotlists)