Entities

BlogPost

BlogPost entity - components, queries, links, and related actions

Your storefront encounters the BlogPost entity when rendering blog listing pages, search results, and individual post detail pages. A BlogPost represents a single article with its content, author, media, and metadata. Posts are organized into BlogCollection entities and can link to user-submitted comments.

Components

Base

BlogPostBase

base

Post title, URL slug, and optional publication date.

Schema

slug

stringrequired

title

stringrequired

publishedAt

Date

Author

BlogPostAuthor

author

Author name, email, and optional biography.

Schema

name

stringrequired

bio

string

Content

BlogPostContent

content

Full HTML-formatted post body.

Schema

content

HtmlFragment { html }required

Excerpt

BlogPostExcerpt

excerpt

HTML-formatted summary or teaser for listing pages.

Schema

excerpt

HtmlFragment { html }required

Media

BlogPostMedia

media

Optional cover image for the post.

Schema

image

{ type, sources, alt, 2 more }

SEO

BlogPostSeo

seo

Meta title, description, and robots directive for the post detail page.

Schema

title

string

description

string

robots

string

E.g. "index, follow", "noindex, nofollow", etc.

BlogPostTags

tags

Array of tag strings assigned to the post.

Schema

string[]

Queries

BlogPostBySlug - Retrieve a single post by its slug.