# Stop catalog (https://docs.pulsarml.com/guides/settings/stop-catalog)

Create the stop causes, group them into a stop catalog and assign it to your machines so their stops can be classified.



The stop catalog holds the causes used to classify each machine's stops. To set it up, open **Settings** and select **Stops**. The **Stops Settings** page has four tabs: **Stop Labels**, **Stop Catalogs**, **Catalog Assignment** and **Stop Automation**. Setting up a catalog takes three steps, one per tab: create the stop labels, build a catalog from them, and assign the catalog to your machines.

<Callout title="Video">
  [Watch how to do it](https://app.trupeer.ai/view/RvevP0ItA/managing-stop-labels-and-catalogs)

  , step by step.
</Callout>

<Screenshot id="stop-catalog-menu" alt="The desktop app's left-hand menu with Settings expanded, listing Stops, Operators, Alerts, Goals, Production, Idle Shifts, Shift Schedule, Real Time, with Stops highlighted. Machine groups and Users Settings are further down the same list, which scrolls." width="240" height="900" />

## Create stop labels [#create-stop-labels]

On the **Stop Labels** tab, stop labels have two levels of causes, each in its own table: **General Stop Causes** and **Specific Stop Causes**. Use the &#x2A;*Search...** box at the top right to find a cause in a long list. You can add causes in two ways:

* **One by one:** click **Add General Cause** or **Add Specific Cause**, type the cause in **Name** and click **Add General Cause** or **Add Specific Cause** in the window.
* **From a file:** click the **Import from CSV** button of that table. In the upload window, download the **sample file**, fill it in, upload it with **Browse and upload your files** and click **Confirm**.

<Callout type="warn">
  To import causes, create one file for General Causes and another for Specific Causes, and import each one from its own table. They can't be in the same file.
</Callout>

To rename or remove a cause, click the three dots (⋮) in its **Action** column and choose **Edit Label** or **Delete**.

### Mark a planned stop [#mark-a-planned-stop]

Planned stops don't count as operational losses in the metrics: Pulsar subtracts them from the shift's total time when it calculates the metrics.

To mark a **specific cause** as a planned stop, click the three dots (⋮) in its **Action** column and select **Set Planned Downtime**. Its **Status** column changes from **Unplanned** to **Planned**. See [Planned and unplanned stops](/guides/settings/planned-and-unplanned-stops) for the details.

<Screenshot id="stop-catalog-planned-stop" alt="Stops Settings, Stop Labels tab: the General Stop Causes table above and the Specific Stop Causes table below, each with Import from CSV and an add button, and the Specific Stop Causes table showing a Status column of Planned or Unplanned. The three-dot menu of a specific cause is open on Edit Label, Set Planned Downtime and Delete." width="1440" height="900" />

## Create a stop catalog [#create-a-stop-catalog]

1. On the **Stop Catalogs** tab, click **New Stop Catalog**.
2. Type the catalog's **Name**. This is very important: you use it to link the catalog to machines in the next step.
3. Under **Stop Labels**, select a **General Cause** and then its causes in **Specific cause**. That list shows every specific cause you created or imported in the previous step: search it, tick as many as you need (or **Select all**) and click **Apply**. Each General Cause needs at least one Specific Cause.
4. Click **Add Cause** to add another General Cause with its specific causes, and repeat until the catalog is complete.
5. Click **Create Stop Catalog**.

<Screenshot id="stop-catalog-new-catalog" alt="The New Stop Catalog window, with the Name field, the Stop Labels row with a General Cause drop-down and a Specific cause drop-down, the Add Cause link below, and the Cancel and Create Stop Catalog buttons." width="562" height="410" />

The **Stop Catalogs** tab lists your catalogs. Click a catalog's name to see its **General Causes** and **Specific Causes**. The three dots (⋮) next to it let you **Edit**, **Duplicate**, **Download** or **Delete** it.

## Assign the stop catalog [#assign-the-stop-catalog]

The last step is to assign each machine its stop catalog.

1. Open the **Catalog Assignment** tab. The table lists each machine with its **Stop Catalog** and its **Custom Label** values.
2. In the **Stop Catalog** column, click the machine's current catalog, or **Select a Stop Catalog** if it has none.
3. Choose the catalog for that machine from the list. There's no separate save button on this tab.

Each machine has one stop catalog, but your operation can have several catalogs, one for each kind of machine.

<Screenshot id="stop-catalog-assign" alt="Stops Settings, Catalog Assignment tab: the Stop Catalog Assignment table with the Machines, Stop Catalog and Custom Label columns. Most machines show Catálogo General, and the Stop Catalog drop-down of a machine that shows Select a Stop Catalog is open with the available catalogs." width="1440" height="900" />

If you have trouble with the stop catalog or need help, contact your Customer Success representative or [raise a support ticket](/guides/getting-started/support-ticket) from the app.