--- 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: 2024-10 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Blog' md: 'https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Blog.txt' --- # 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/2024-10/connections/ArticleConnection) non-null List of the blog's articles. * articles​Count [Count](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Count) Count of articles. * comment​Policy [Comment​Policy!](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/scalars/DateTime) non-null The date and time when the blog was created. * events [Event​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/EventConnection) non-null The paginated list of events associated with the host subject. * feed [Blog​Feed](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/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/2024-10/scalars/ID) non-null A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/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. * tags [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/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/2024-10/scalars/String) non-null The title of the blog. * translations [\[Translation!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Translation) non-null The published translations associated with the resource. * updated​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/DateTime) The date and time when the blog was update. ### Deprecated fields * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MetafieldDefinitionConnection) non-nullDeprecated * private​Metafield [Private​Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PrivateMetafield) Deprecated * private​Metafields [Private​Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/PrivateMetafieldConnection) non-nullDeprecated *** ## Map ### Fields and connections with this object * {}[Article.blog](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Article#field-blog) * <->[BlogConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/BlogConnection#field-nodes) * {}[BlogEdge.node](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/BlogEdge#field-node) ### Possible type in * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/2024-10/unions/MetafieldReferencer) *** ## Queries * [blog](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/blog) query Returns a `Blog` resource by ID. * [blogs](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/blogs) query List of the shop's blogs. *** ## \Blog Queries ### Queried by * \[blog](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/Blog) * \[blogs](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/BlogConnection) *** ## Mutations * [blog​Create](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/blogCreate) mutation Creates a blog. * [blog​Update](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/blogUpdate) mutation Updates a blog. *** ## <\~> Blog Mutations ### Mutated by * <\~>[blog​Create](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/blogCreate) * <\~>[blog​Update](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/blogUpdate) *** ## Interfaces * * [Has​Events](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasEvents) interface * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafieldDefinitions) interface * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafields) interface * [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasPublishedTranslations) interface * [Node](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/Node) interface *** ## ||-Blog Implements ### Implements * ||-[Has​Events](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasEvents) * ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafieldDefinitions) * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafields) * ||-[Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasPublishedTranslations) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/Node)