--- title: Blog - GraphQL Admin description: >- Shopify stores come with a built-in blogging engine, allowing a shop to have one or more blogs. Blogs are meant to be used as a type of magazine or newsletter for the shop, with content that changes over time. api_version: unstable api_name: admin source_url: html: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/Blog' md: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/Blog.md' --- # Blog object Requires `read_content` access scope or `read_online_store_pages` access scope. Shopify stores come with a built-in blogging engine, allowing a shop to have one or more blogs. Blogs are meant to be used as a type of magazine or newsletter for the shop, with content that changes over time. ## Fields * articles [Article​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/ArticleConnection) non-null List of the blog's articles. * articles​Count [Count](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Count) Count of articles. Limited to a maximum of 10000 by default. * comment​Policy [Comment​Policy!](https://shopify.dev/docs/api/admin-graphql/unstable/enums/CommentPolicy) non-null Indicates whether readers can post comments to the blog and if comments are moderated or not. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime) non-null The date and time when the blog was created. * events [Event​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/EventConnection) non-null The paginated list of events associated with the host subject. * feed [Blog​Feed](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BlogFeed) FeedBurner provider details. Any blogs that aren't already integrated with FeedBurner can't use the service. * handle [String!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) non-null A unique, human-friendly string for the blog. If no handle is specified, a handle will be generated automatically from the blog title. The handle is customizable and is used by the Liquid templating language to refer to the blog. * id [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID) non-null A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield) A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. * metafields [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/MetafieldConnection) non-null A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * metafields​By​Identifiers [\[Metafield\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metafield) non-null The metafields associated with the resource matching the supplied list of namespaces and keys. * tags [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) non-null A list of tags associated with the 200 most recent blog articles. * template​Suffix [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) The name of the template a blog is using if it's using an alternate template. Returns `null` if a blog is using the default blog.liquid template. * title [String!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) non-null The title of the blog. * translations [\[Translation!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Translation) non-null The published translations associated with the resource. * updated​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime) The date and time when the blog was update. * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/MetafieldDefinitionConnection) non-nullDeprecated *** ## Map ### Fields and connections with this object * {}[Article.blog](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Article#field-Article.fields.blog) * <->[BlogConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/BlogConnection#returns-nodes) * {}[BlogEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/BlogEdge#field-BlogEdge.fields.node) ### Possible type in * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/unstable/unions/MetafieldReferencer) *** ## Queries * [blog](https://shopify.dev/docs/api/admin-graphql/unstable/queries/blog) query Returns a `Blog` resource by ID. * [blogs](https://shopify.dev/docs/api/admin-graphql/unstable/queries/blogs) query List of the shop's blogs. *** ## \Blog Queries ### Queried by * \[blog](https://shopify.dev/docs/api/admin-graphql/unstable/queries/blog) * \[blogs](https://shopify.dev/docs/api/admin-graphql/unstable/queries/blogs) *** ## Mutations * [blog​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/blogCreate) mutation Creates a blog. * [blog​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/blogUpdate) mutation Updates a blog. *** ## <\~> Blog Mutations ### Mutated by * <\~>[blog​Create](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/blogCreate) * <\~>[blog​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/blogUpdate) *** ## Interfaces * * [Has​Events](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasEvents) interface * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafieldDefinitions) interface * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafields) interface * [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasPublishedTranslations) interface * [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node) interface *** ## ||-Blog Implements ### Implements * ||-[Has​Events](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasEvents) * ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafieldDefinitions) * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasMetafields) * ||-[Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasPublishedTranslations) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)