---
title: MarketCatalog - GraphQL Admin
description: |-
  A catalog for managing product availability and pricing for specific [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) contexts. Each catalog links to one or more markets and defines what [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects customers see through its [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication) settings. The catalog can include a [`PriceList`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList) for market-specific pricing adjustments.

  Use catalogs to create distinct shopping experiences for different geographic regions or customer segments.

  Learn more about [building a catalog](https://shopify.dev/docs/apps/build/markets/build-catalog) and [managing markets](https://shopify.dev/docs/apps/build/markets).
api_version: unstable
api_name: admin
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/unstable/objects/marketcatalog
  md: https://shopify.dev/docs/api/admin-graphql/unstable/objects/marketcatalog.md
---

# Market​Catalog

object

Requires `read_products` access scope.

A catalog for managing product availability and pricing for specific [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) contexts. Each catalog links to one or more markets and defines what [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects customers see through its [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication) settings. The catalog can include a [`PriceList`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList) for market-specific pricing adjustments.

Use catalogs to create distinct shopping experiences for different geographic regions or customer segments.

Learn more about [building a catalog](https://shopify.dev/docs/apps/build/markets/build-catalog) and [managing markets](https://shopify.dev/docs/apps/build/markets).

## Fields

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID)

  non-null

  A globally-unique ID.

* markets

  [Market​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/MarketConnection)

  non-null

  The markets associated with the catalog.

  * type

    [Market​Type](https://shopify.dev/docs/api/admin-graphql/unstable/enums/MarketType)

    Default:null

    ### Arguments

    Filters markets by type.

  * status

    [Market​Status](https://shopify.dev/docs/api/admin-graphql/unstable/enums/MarketStatus)

    Default:null

    Filters markets by status.

  * first

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* markets​Count

  [Count](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Count)

  The number of markets associated with the catalog.

  * type

    [Market​Type](https://shopify.dev/docs/api/admin-graphql/unstable/enums/MarketType)

    Default:null

    ### Arguments

    Filters markets by type.

  * status

    [Market​Status](https://shopify.dev/docs/api/admin-graphql/unstable/enums/MarketStatus)

    Default:null

    Filters markets by status.

  * query

    [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

    A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

    * * default

        string

      * id

        id

      * market\_condition\_types

        string

      - Filter by a case-insensitive search of multiple fields in a document.

      - Example:

        * `query=Bob Norman`
        * `query=title:green hoodie`

        Filter by `id` range.

      - Example:

        * `id:1234`
        * `id:>=1234`
        * `id:<=1234`

        A comma-separated list of condition types.

    * market\_type

      string

    * name

      string

    * * status

        string

      * wildcard\_company\_location\_with\_country\_code

        string

      -
      - Valid values:
        * `ACTIVE`
        * `DRAFT`

  * limit

    [Int](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int)

    The upper bound on count value before returning a result. Use `null` to have no limit.

  ***

* operations

  [\[Resource​Operation!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/ResourceOperation)

  non-null

  Most recent catalog operations.

* price​List

  [Price​List](https://shopify.dev/docs/api/admin-graphql/unstable/objects/PriceList)

  The price list associated with the catalog.

* publication

  [Publication](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Publication)

  A group of products and collections that's published to a catalog.

* status

  [Catalog​Status!](https://shopify.dev/docs/api/admin-graphql/unstable/enums/CatalogStatus)

  non-null

  The status of the catalog.

* title

  [String!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String)

  non-null

  The name of the catalog.

***

## Map

### Fields and connections with this object

* {}[Market.catalogs](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Market#field-Market.fields.catalogs)
* <->[MarketCatalogConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/MarketCatalogConnection#returns-nodes)
* {}[MarketCatalogEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MarketCatalogEdge#field-MarketCatalogEdge.fields.node)
* {}[MarketsResolvedValues.catalogs](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MarketsResolvedValues#field-MarketsResolvedValues.fields.catalogs)

***

## Interfaces

* * [Catalog](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Catalog)

    interface

  * [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)

    interface

***

## ||-MarketCatalog Implements

### Implements

* ||-[Catalog](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Catalog)
* ||-[Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)