---
title: publicationCreate - GraphQL Admin
description: >-
  Creates a
  [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication)
  that controls which

  [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product)
  and
  [`Collection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection)

  customers can access through a
  [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog).


  ### When to create a publication


  Publications are **optional** for catalogs. Only create a publication if you

  need to control which products are visible in a specific catalog context. When

  a publication isn't associated with a catalog, product availability is

  determined by the sales channel.


  **Create a publication if you need to:**

  - Restrict product visibility to a subset of your inventory for a specific
  market or company location

  - Publish different product selections to different contexts


  **Do NOT create a publication if:**

  - You want product availability determined by the sales channel

  - You only need custom pricing (use a price list on the catalog instead)


  ### Configuration options


  You can create an empty publication and add products later, or prepopulate it

  with all existing products. The
  [`autoPublish`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationCreate#arguments-input.fields.autoPublish)

  field determines whether the publication automatically adds newly created
  products.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationCreate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationCreate.md
api_name: admin
api_type: graphql
type: mutation
---

# publication​Create

mutation

Requires `write_publications` access scope. Also: The user must have a permission to create and edit catalogs.

Creates a [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication) that controls which [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [`Collection`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) customers can access through a [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog).

### When to create a publication

Publications are **optional** for catalogs. Only create a publication if you need to control which products are visible in a specific catalog context. When a publication isn't associated with a catalog, product availability is determined by the sales channel.

**Create a publication if you need to:**

* Restrict product visibility to a subset of your inventory for a specific market or company location
* Publish different product selections to different contexts

**Do NOT create a publication if:**

* You want product availability determined by the sales channel
* You only need custom pricing (use a price list on the catalog instead)

### Configuration options

You can create an empty publication and add products later, or prepopulate it with all existing products. The [`autoPublish`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationCreate#arguments-input.fields.autoPublish) field determines whether the publication automatically adds newly created products.

## Arguments

* input

  [Publication​Create​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/PublicationCreateInput)

  required

  The input fields to use when creating the publication.

***

## Publication​Create​Payload returns

* publication

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

  The publication that's been created.

* user​Errors

  [\[Publication​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/PublicationUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### publicationCreate reference