> For the complete documentation index, see [llms.txt](https://docs.in8sync.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.in8sync.com/client-admin-guide/creating-catalogs/managing-catalogs.md).

# Managing Catalogs

The Catalogs list page — find catalogs, see build status at a glance, trigger reprocesses, and delete catalogs you no longer use

The Catalogs list is your overview of every catalog on the active subsidiary — name, description, build status, and the per-row actions you'll use most often.

## When you'd use this page

* Confirming a catalog is up to date.
* Triggering a reprocess after NetSuite data changes.
* Finding a specific catalog when the list is long.
* Deleting a catalog that's no longer used.

To **edit** a catalog's configuration (sections, criteria, fields, attributes), click its row to open the Edit Catalog page — see [Creating a Catalog](/client-admin-guide/creating-catalogs.md).

## Open the Catalogs page

Click **Catalogs** in the sidebar. The page heading reads *Catalogs* with subtitle *Manage your NetSuite product catalogs*. A *Search* card sits above the table; the table card itself is titled **Catalogs ({count})**.

![Catalogs list page with status badges and row actions](https://229581143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAG04Mxmhw6PLRAZBvhtK%2Fuploads%2Fgit-blob-f867c15e629fead7b0f8d532b6a3cd57655a46cf%2Fcatalogs-list.png?alt=media)

## Columns

| Column          | What it shows                                                        |
| --------------- | -------------------------------------------------------------------- |
| **Name**        | The catalog's display name.                                          |
| **Description** | The optional description set on the catalog.                         |
| **Status**      | A badge showing where the catalog is in its build cycle (see below). |
| **Actions**     | Row icons — Edit, Refresh, Reprocess, Delete.                        |

## Status badges

The Status column tells you where the catalog is in its build pipeline. The list auto-refreshes statuses every few seconds for catalogs that are pending or processing, so you don't have to keep reloading.

| Badge          | Meaning                                                                                      |
| -------------- | -------------------------------------------------------------------------------------------- |
| **Ready**      | Idle, ready to be built.                                                                     |
| **Pending**    | Queued for processing.                                                                       |
| **Processing** | Build in progress.                                                                           |
| **Completed**  | Built successfully. The badge also shows the item count and the timestamp of the last build. |
| **Failed**     | The build errored. Hover the badge for the error message.                                    |

## Row actions

Each row has four icon buttons. Hover any of them to see its tooltip.

| Icon              | Tooltip / action              | What it does                                                                                                                                                                                                                                                                                                                                                   |
| ----------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ✏️ Pencil         | **Edit catalog**              | Opens the Edit Catalog page.                                                                                                                                                                                                                                                                                                                                   |
| 🔄 Circular arrow | **Refresh processing status** | Re-fetches the catalog's current build status from the server — it does **not** trigger a rebuild or change any catalog data. Use this if the status badge looks stuck or stale after you expected a build to finish.                                                                                                                                          |
| ▷ Play            | **Reprocess catalog**         | Triggers a full rebuild using the latest data from NetSuite. The catalog goes to **Pending**, then **Processing**, then **Completed**. A confirmation dialog reads: *This will set the processing status to pending and trigger reprocessing. The catalog file will be regenerated in the background. Do you want to proceed?* Click **Reprocess** to confirm. |
| 🗑 Trash          | **Delete catalog**            | Permanently removes the catalog. A confirmation dialog asks if you're sure.                                                                                                                                                                                                                                                                                    |

**Refresh vs Reprocess — the key difference:** Use **Refresh** only to update the status badge when it looks wrong. Use **Reprocess** when you want the catalog's actual data to be updated.

### What end users see during a Reprocess

While a catalog is rebuilding (**Pending** or **Processing** status), portals continue serving the most recently completed version of the catalog — there's no outage or blank page for end users. The new data becomes live for end users on the next page load after the status returns to **Completed**.

### When to trigger a Reprocess

Trigger a Reprocess on a catalog whenever any of the following have changed in NetSuite or in the catalog's own settings:

* New items were added to NetSuite categories that this catalog includes
* Existing items were edited (prices, fields, images, variants)
* A category's name or structure changed in NetSuite
* Your NetSuite Admin updated the global Catalog Restrictions that apply to this subsidiary
* You changed category selections or criteria inside the catalog and saved with **Save** (not Save & Update)
* You enabled or disabled Settings toggles (Price Levels, Locations, Matrix Items, etc.) and only clicked Save

{% hint style="info" %}
There's no "Download" or "Export" action on a catalog row. The catalog output is consumed by portal pages directly, not as a downloadable file.
{% endhint %}

## Search

The Search card at the top of the page filters the table by **name or description** as you type. Clearing the field restores the full list.

## Create a new catalog

The **+ New** button is in the top-right of the page. It opens *Create New Catalog* — see [Creating a Catalog](/client-admin-guide/creating-catalogs.md) for the full walkthrough.

## What success looks like

* You can find any catalog quickly via search.
* Status badges show the current state of every build at a glance.
* Reprocess and Delete are both reachable in two clicks.

## Common issues

* **A catalog stays&#x20;*****Processing*****&#x20;for a long time** — large catalogs with thousands of items take time. The list auto-refreshes; you don't need to reload. If it's been hours, ask your NetSuite Admin to check the processing logs.
* **A catalog shows&#x20;*****Failed*** — hover the badge for the error. Common causes: a referenced custom field was renamed in NetSuite, or a category that was selected has been removed. Open the catalog and re-confirm its configuration.
* **The Reprocess dialog won't close** — refresh the page; this is rare and usually clears.
* **Deleted a catalog by accident** — there's no undo. The catalog has to be rebuilt from scratch.

## Best practice

* After your NetSuite Admin makes changes that affect catalog data (new categories, renamed fields, restructured items), trigger **Reprocess** on any affected catalog so the portal reflects the change. Don't wait for the next scheduled refresh if you need it live now.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Creating a Catalog</strong></td><td>Walk through every section of the Edit Catalog page.</td><td><a href="/client-admin-guide/creating-catalogs.md">Catalogs</a></td></tr><tr><td><strong>Best Practices</strong></td><td>Tips for catalog hygiene over time.</td><td><a href="/client-admin-guide/creating-catalogs/best-practices.md">Best Practices</a></td></tr></tbody></table>
