--- title: Publication - GraphQL Admin description: >- A group of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) that are published to an app. Each publication manages which products and collections display on its associated [`Channel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel). Merchants can automatically publish products when they're created if [`autoPublish`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.autoPublish) is enabled, or manually control publication through publication records. Publications support scheduled publishing through future publish dates for online store channels, allowing merchants to coordinate product launches and promotional campaigns. The [`catalog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.catalog) field links to pricing and availability rules specific to that publication's context. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication.md' --- # Publication object A group of [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection) that are published to an app. Each publication manages which products and collections display on its associated [`Channel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel). Merchants can automatically publish products when they're created if [`autoPublish`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.autoPublish) is enabled, or manually control publication through publication records. Publications support scheduled publishing through future publish dates for online store channels, allowing merchants to coordinate product launches and promotional campaigns. The [`catalog`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.catalog) field links to pricing and availability rules specific to that publication's context. ## Fields * auto​Publish [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether new products are automatically published to this publication. * catalog [Catalog](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) The catalog associated with the publication. * collection​Publications​V3 [Resource​Publication​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ResourcePublicationConnection) non-null The list of collection publication records, each representing the publication status and details for a collection published to this publication (typically channel). * collections [Collection​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/CollectionConnection) non-null The list of collections published to the publication. * has​Collection [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the collection is available to the publication. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments Collection ID to check. *** * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * included​Products [Product​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ProductConnection) non-null The list of products included, but not necessarily published, in the publication. * included​Products​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) The count of products included in the publication. Limited to a maximum of 10000 by default. * operation [Publication​Operation](https://shopify.dev/docs/api/admin-graphql/latest/unions/PublicationOperation) A background operation associated with this publication. * product​Publications​V3 [Resource​Publication​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ResourcePublicationConnection) non-null The product publications for the list of products published to the publication. * products [Product​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ProductConnection) non-null The list of products published to the publication. * supports​Future​Publishing [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the publication supports future publishing. ### Deprecated fields * app [App!](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) non-nullDeprecated * name [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-nullDeprecated *** ## Map ### Fields and connections with this object * {}[AppCatalog.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCatalog#field-AppCatalog.fields.publication) * {}[AppInstallation.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation#field-AppInstallation.fields.publication) * ||-[Catalog.publication](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog#fields-publication) * {}[Collection.unpublishedPublications](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection#field-Collection.fields.unpublishedPublications) * {}[CollectionPublication.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/CollectionPublication#field-CollectionPublication.fields.publication) * {}[CompanyLocationCatalog.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationCatalog#field-CompanyLocationCatalog.fields.publication) * {}[MarketCatalog.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCatalog#field-MarketCatalog.fields.publication) * {}[Order.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.publication) * {}[Product.unpublishedPublications](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product#field-Product.fields.unpublishedPublications) * <->[PublicationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/PublicationConnection#returns-nodes) * {}[PublicationEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/PublicationEdge#field-PublicationEdge.fields.node) * ||-[Publishable.unpublishedPublications](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Publishable#fields-unpublishedPublications) * {}[ResourcePublication.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/ResourcePublication#field-ResourcePublication.fields.publication) * {}[ResourcePublicationV2.publication](https://shopify.dev/docs/api/admin-graphql/latest/objects/ResourcePublicationV2#field-ResourcePublicationV2.fields.publication) *** ## Queries * [publication](https://shopify.dev/docs/api/admin-graphql/latest/queries/publication) query Retrieves a [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication) by [`ID`](https://shopify.dev/docs/api/usage/gids). Returns `null` if the publication doesn't exist. * [publications](https://shopify.dev/docs/api/admin-graphql/latest/queries/publications) query Returns a paginated list of [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication). Filter publications by [`CatalogType`](https://shopify.dev/docs/api/admin-graphql/latest/enums/CatalogType). *** ## \Publication Queries ### Queried by * \[publication](https://shopify.dev/docs/api/admin-graphql/latest/queries/publication) * \[publications](https://shopify.dev/docs/api/admin-graphql/latest/queries/publications) *** ## Mutations * [publication​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationCreate) mutation 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). 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. * [publication​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationUpdate) mutation Updates a [`Publication`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication). You can add or remove [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) from the publication, with a maximum of 50 items per operation. The [`autoPublish`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationUpdate#arguments-input.fields.autoPublish) field determines whether new products automatically display in this publication. *** ## <\~> Publication Mutations ### Mutated by * <\~>[publication​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationCreate) * <\~>[publication​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/publicationUpdate) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-Publication Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)