---
title: Create saved catalogs in the Dev Dashboard
description: >-
  Learn how saved catalogs scope what your AI agents can find, and how to get
  the API credentials your agents authenticate with.
source_url:
  html: 'https://shopify.dev/docs/apps/build/dev-dashboard/catalogs'
  md: 'https://shopify.dev/docs/apps/build/dev-dashboard/catalogs.md'
---

# Create saved catalogs in the Dev Dashboard

**Catalogs** in the [Dev Dashboard](https://dev.shopify.com/dashboard/) is where you build a saved catalog, test it against real products, and get the credentials your agents authenticate with. A saved catalog is a named, reusable set of search parameters, so your agents don't have to send the same filters on every request.

For what catalogs are and how agents query them, refer to [About Catalogs](https://shopify.dev/docs/agents/catalog).

***

## Configure a catalog

A saved catalog narrows the [Global Catalog](https://shopify.dev/docs/agents/catalog/global-catalog) to the products you want an agent to see, scoped by things like source, region, product attributes, and availability.

Each saved catalog has an ID, which your agents send as `catalog.catalog_id` to apply the catalog's settings to a search. `catalog.saved_catalog_slug` carries the same value but is a [deprecated alias](https://shopify.dev/docs/agents/catalog/global-catalog), so use `catalog.catalog_id` in new integrations.

![A saved catalog in the Dev Dashboard, with its Configuration panel of source, query, region, and attribute filters beside a Search preview.](https://shopify.dev/assets/assets/images/apps/dev-dashboard/catalogs-workspace-DINbeYVa.png)

***

## Preview a search

**Search preview** runs a query against your catalog and shows you both the request and the response, so you can check what your filters return before an agent depends on them.

You can search by text, or attach an image to find visually similar products. Images must be PNG, JPEG, WebP, or HEIC, and 4 MB or smaller.

**Note:**

Search preview runs on your organization's first Catalogs API key. If a preview fails because of a rate limit, that reflects how much traffic the key is handling, not a problem with your catalog's configuration.

***

## Get API credentials

Your agents authenticate to the Catalogs API with the **Client ID** and **Client secret** from an **API key** created here, which they exchange for an access token. Refer to [Authentication](https://shopify.dev/docs/agents/get-started/authentication). A key also carries the **Redirect URLs** used by flows that send a buyer back to your app. Redirect URLs must be `https://`, except on `localhost`.

***

## Next steps

* [About Catalogs](https://shopify.dev/docs/agents/catalog) to compare the Global and Storefront Catalog interfaces before pointing an agent at one.
* [Discover products with Shopify Catalog](https://shopify.dev/docs/agents/get-started/search-catalog) to run your first search and walk a buyer through selecting a variant.

***