Przejdź do głównej zawartości

BlogPost

Blog post

type BlogPost {
  allowComments: Boolean!
  author: BlogAuthor!
  category: BlogCategory
  commentCount: Int!
  content(
    format: RichTextFormat = HTML
  ): String!
  contentFormat: ContentFormat! @deprecated
  createdAt: DateTime!
  excerpt: String
  featuredImage: Image
  handle: String!
  id: ID!
  isFeatured: Boolean!
  products(
    after: String
    first: Int
    reverse: Boolean = false
    sortKey: ProductSortKeys = CREATED_AT
  ): ProductConnection!
  publishedAt: DateTime
  readingTimeMinutes: Int!
  seo: SEO
  status: BlogPostStatus!
  tags: [BlogTag!]!
  title: String!
  updatedAt: DateTime!
  viewCount: Int!
}

Fields​

BlogPost.allowComments ● Boolean! non-null scalar​

Whether comments are allowed

BlogPost.author ● BlogAuthor! non-null object​

Post author

BlogPost.category ● BlogCategory object​

Post category

BlogPost.commentCount ● Int! non-null scalar​

Comment count

BlogPost.content ● String! non-null scalar​

Blog post content. Returns ready-to-render HTML by default; pass format: TEXT for plain text or format: JSON for the structured document.

BlogPost.content.format ● RichTextFormat enum​

Representation to return: HTML (ready-to-render markup, default), TEXT (plain text), or JSON (structured document).

BlogPost.createdAt ● DateTime! non-null scalar​

Created date (ISO 8601)

BlogPost.excerpt ● String scalar​

Short excerpt/summary

Featured image

BlogPost.handle ● String! non-null scalar​

URL-friendly handle

BlogPost.id ● ID! non-null scalar​

Post ID

Whether post is featured

BlogPost.products ● ProductConnection! non-null object​

Products the merchant pinned to this entity — directly, via product categories, or via collections. Always a connection: empty when nothing is pinned. Only products visible on the storefront are included.

BlogPost.products.after ● String scalar​

Cursor for forward pagination (cursor of the last edge from the previous page)

BlogPost.products.first ● Int scalar​

Number of products to return from the start (forward pagination, max 100)

BlogPost.products.reverse ● Boolean scalar​

Reverse the sort order when true (descending by sortKey)

BlogPost.products.sortKey ● ProductSortKeys enum​

Sort key for ordering the pinned products

BlogPost.publishedAt ● DateTime scalar​

Published date (ISO 8601)

BlogPost.readingTimeMinutes ● Int! non-null scalar​

Estimated reading time in minutes

BlogPost.seo ● SEO object​

SEO metadata

BlogPost.status ● BlogPostStatus! non-null enum​

Post status

BlogPost.tags ● [BlogTag!]! non-null object​

Post tags

BlogPost.title ● String! non-null scalar​

Post title

BlogPost.updatedAt ● DateTime! non-null scalar​

Updated date (ISO 8601)

BlogPost.viewCount ● Int! non-null scalar​

View count

Show deprecatedHide deprecated

BlogPost.contentFormat ● ContentFormat! deprecated non-null enum​

DEPRECATED

Content is always served ready-to-render via content(format: HTML) (or TEXT/JSON). This field is redundant and is scheduled for removal after 2026-09-02.

Stored content format (DEPRECATED — use content(format: ...) to pick a representation).

Returned By​

blogPost query

Member Of​

BlogPostEdge object