# Managing Catalogs
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})**.
## 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 *****Processing***** 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 *****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
Creating a Catalog
Walk through every section of the Edit Catalog page.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.in8sync.com/client-admin-guide/creating-catalogs/managing-catalogs.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.