Commerce glossary

Blog, pages and media

The words and pictures a store publishes beside its products: blog posts, custom pages, the editor staff write them in, and the media library that holds every image and video.

45 parts and 14 phrases. Apps in this area include Shopify blog, WordPress, Contentful, Sanity, Storyblok, Cloudinary.

Blogcontent.blogShowDated articles with an author, listed newest first on the store's blog.
Blog postcontent.blog.postShowOne article and the facts stored with it.

How to extend

  • SectionMany side by sideA storefront section type lists the latest posts on any page.
  • SlotMany side by sidestorefront.slot.blog.below_postA plugin renders its own block, such as comments or a newsletter form, under a post.
PartLitestore todayHow to extend
Blog articlecontent.blog.post.articleA blog article is a markdown file with a title, description, publish date and body, shown at its own address under the blog.
Coremodules/storefront/blog/posts.ts
Section · manySlot · many
Post authorcontent.blog.post.authorA post author holds the writer's name, photo and social handle, shown on the post and in its structured data.
Coremodules/storefront/blog/author.tsx
Section · manySlot · many
Cover imagecontent.blog.post.cover_imageA cover image is the picture shown at the top of a post and on its card in the blog list.
Coremodules/storefront/blog/post-card.tsx
Section · manySlot · many
Products in a postcontent.blog.post.linked_productsProducts in a post are a list of product slugs stored with the post and shown as product cards on it.
Coreapp/(web)/blog/[slug]/page.tsx
Section · manySlot · many
Post tagcontent.blog.post.tagA post tag is a label on a post that groups it with other posts on a tag page.
Plugin
Section · manySlot · many
Several blogscontent.blog.post.multiple_blogsSeveral blogs split posts into separate lists, such as News and Guides, each at its own address.
Plugin
Section · manySlot · many
Post commentcontent.blog.post.commentA post comment is a reader's reply stored under a post, held for moderation before it shows.
Plugin
Section · manySlot · many
Blog listing and feedscontent.blog.listingShowWhere readers and other software find the posts.

How to extend

  • ProviderMany side by sidecontent feedA plugin adds another way out for posts, such as an RSS feed or a newsletter digest.
PartLitestore todayHow to extend
Blog index pagecontent.blog.listing.indexThe blog index page lists every published post as a card, newest first.
Coreapp/(web)/blog/page.tsx
Provider · many
Sitemap entrycontent.blog.listing.sitemap_entryA sitemap entry adds each published post's address to the store's sitemap for search engines.
Coreapp/sitemap.ts
Provider · many
Post feed filecontent.blog.listing.syndication_feedA post feed file publishes the latest posts in a standard format such as RSS or Atom that feed readers poll.
Plugin
Provider · many
Pagescontent.pageShowFixed pages such as the home page, About or FAQ, each at its own address.
Custom pagescontent.page.customShowPages the store builds itself, from the home page to policy and landing pages.

How to extend

  • SectionMany side by sideA page is an ordered list of section types, and a plugin adds a new section type rather than a new page kind.
  • Assistant toolMany side by sidesavePageThe assistant writes and updates a page through the savePage tool.
PartLitestore todayHow to extend
Custom pagecontent.page.custom.pageA custom page is a stored page with a name, an address under /pages and an ordered list of sections that the storefront renders.
Coremodules/storefront/pages/page.ts
Section · manyAssistant tool · many
Home pagecontent.page.custom.home_pageThe home page is the one page shown at the store's root address, built from the same sections as a custom page.
Coremodules/storefront/pages/page-view.tsx
Section · manyAssistant tool · many
Old address redirectcontent.page.custom.slug_redirectAn old address redirect stores a page's previous slugs and sends visitors from an old address to the current one.
Coremodules/storefront/slug-redirects.ts
Section · manyAssistant tool · many
Page templatecontent.page.custom.page_templateA page template is a saved page layout that new pages start from.
Plugin
Section · manyAssistant tool · many
Members-only pagecontent.page.custom.members_onlyA members-only page shows its content only to signed-in customers and a sign-in prompt to everyone else.
Plugin
Section · manyAssistant tool · many
Mediacontent.mediaShowThe images and videos the store stores, describes and attaches to products, pages and posts.
Media librarycontent.media.libraryShowThe one store of images and videos every part of the admin picks from.

How to extend

  • ProviderOne per storefile storageOne file storage per store holds uploads, such as S3 or an S3-compatible bucket.
  • Assistant toolMany side by sidefindMediaThe assistant finds pictures in the library by alt text through the findMedia tool.
PartLitestore todayHow to extend
Media itemcontent.media.library.itemA media item is one stored image or video with its address, size, file type, dimensions and uploader.
Coremodules/media/admin
Provider · oneAssistant tool · many
File uploadcontent.media.library.uploadA file upload sends a file from the admin to the store's file storage and creates a media item for it.
Coreapp/api/upload/route.ts
Provider · oneAssistant tool · many
Image from a linkcontent.media.library.remote_urlAn image from a link creates a media item that points at a picture hosted elsewhere, without copying the file.
Coremodules/media/media-url.ts
Provider · oneAssistant tool · many
Alt textcontent.media.library.alt_textAlt text is a short description stored on a media item and read aloud by screen readers and used by search engines.
Coremodules/media/admin/editor.tsx
Provider · oneAssistant tool · many
Video filecontent.media.library.videoA video file is a media item of type video, played on product and page sections.
Coremodules/media/admin/schema.ts
Provider · oneAssistant tool · many
File type checkcontent.media.library.file_checkA file type check reads the first bytes of an upload and rejects anything that is not an allowed image or video format.
Coremodules/media/sniff.ts
Provider · oneAssistant tool · many
Media attachmentcontent.media.library.attachmentA media attachment links a media item to a product, variant, collection, category or campaign, with an order and a primary flag.
Coremodules/media/associations.ts
Provider · oneAssistant tool · many
Media foldercontent.media.library.folderA media folder groups media items under a name so staff browse them by folder.
Plugin
Provider · oneAssistant tool · many
Document filescontent.media.library.documentsDocument files are PDFs and other non-image files stored in the library and linked from pages.
Plugin
Provider · oneAssistant tool · many
Image deliverycontent.media.deliveryShowHow stored images reach the shopper's screen at the right size.

How to extend

  • ProviderOne per storeimage serviceOne image service per store resizes and serves pictures, such as the framework's image optimiser or an outside image CDN.
PartLitestore todayHow to extend
Resized copiescontent.media.delivery.resizeResized copies are smaller versions of each image made per screen width and cached for a year.
Corenext.config.ts
Provider · one
Modern image formatcontent.media.delivery.modern_formatA modern image format such as WebP is served to browsers that accept it in place of the original file.
Corenext.config.ts
Provider · one
Image editingcontent.media.delivery.editImage editing crops, rotates or removes the background of a picture inside the library.
Plugin
Provider · one
Customer uploadscontent.media.customerShowPictures that shoppers and sellers add from the storefront.

How to extend

  • EventMany side by sideevent.review.submittedA plugin checks a customer's photo, such as for pre-moderation, by subscribing to the review event that carries it.
PartLitestore todayHow to extend
Customer photo uploadcontent.media.customer.uploadA customer photo upload stores an image a signed-in customer adds to a review or a message, limited by size, type and a per-hour count.
Coremodules/media/customer-upload.ts
Event · many
File upload fieldcontent.media.customer.file_fieldA file upload field on a product page stores a file the customer attaches to an order line, such as artwork for printing.
Plugin
Event · many
Publishingcontent.publishShowWhen a post or page goes live, and what happens before and after.

How to extend

  • Core onlyWho sees a draft is set by one viewer-audience check in core, so staff previews and customer views cannot disagree.
PartLitestore todayHow to extend
Draftcontent.publish.draftA draft is a post or page that is saved but hidden from customers, search engines and the sitemap.
Coremodules/storefront/blog/posts.ts
Core only
Show or hide pagecontent.publish.visibility_toggleShowing or hiding a page switches it live or off for customers without deleting it.
Coremodules/storefront/admin/pages/page-publication-card.tsx
Core only
Staff previewcontent.publish.staff_previewA staff preview shows a hidden page to signed-in staff with a preview banner and a noindex tag.
Coremodules/storefront/visibility/audience.ts
Core only
Scheduled publishingcontent.publish.scheduledScheduled publishing stores a future date and time on a post or page and makes it live when that time arrives.
Plugin
Core only
Revision historycontent.publish.revisionRevision history stores earlier versions of a post or page so staff compare them and restore one.
Plugin
Core only
Editorial approvalcontent.publish.approvalEditorial approval holds a writer's change until an editor approves it for publishing.
Plugin
Core only
Editorcontent.editorShowThe writing surface staff use for posts, pages and product descriptions.

How to extend

  • Assistant toolMany side by sideupdateProductContentsavePageThe assistant drafts text into the same fields staff edit, through its content tools.
  • Core onlyThe HTML cleaner stays in core, because every stored page and description passes the same allowlist.
PartLitestore todayHow to extend
Rich text editorcontent.editor.rich_textThe rich text editor formats headings, lists, links and bold text with a toolbar and stores the result as HTML.
Coreui/rich-text-editor.tsx
Assistant tool · manyCore only
Markdown modecontent.editor.markdownMarkdown mode stores the editor's text as markdown, which blog posts are written in.
Coreui/rich-text-editor.tsx
Assistant tool · manyCore only
Insert imagecontent.editor.insert_imageThe insert-image button opens the media library and places the chosen image at the cursor.
Coreui/admin/forms/editor-image-button.tsx
Assistant tool · manyCore only
Post componentscontent.editor.post_componentsPost components are named blocks, such as a product entry card, written inside a markdown post and rendered as page elements.
Coremodules/storefront/blog/mdx-components.tsx
Assistant tool · manyCore only
HTML cleaningcontent.editor.html_cleaningHTML cleaning strips scripts, frames, styles and event attributes from stored HTML and keeps an allowlist of tags.
Coreplatform/sanitize-html.ts
Assistant tool · manyCore only
Video or social embedcontent.editor.embedAn embed shows a video or social post from another site inside a post or page.
Plugin
Assistant tool · manyCore only
Content modelcontent.modelShowStructured content types beyond posts and pages, as in a headless CMS.

How to extend

  • ProviderMany side by sidecontent sourceA plugin reads structured content from an outside CMS and renders it in a storefront section.
PartLitestore todayHow to extend
Content typecontent.model.content_typeA content type is a named set of fields, such as a store location with an address and opening hours, that entries follow.
Plugin
Provider · many
Content entrycontent.model.entryA content entry is one record of a content type with its field values filled in.
Plugin
Provider · many
Content delivery APIcontent.model.delivery_apiA content delivery API serves entries as data to any front end that requests them.
Plugin
Provider · many
Page and post translationcontent.model.translationA page or post translation stores the text in another language beside the original, while product and collection translations live in the store's translation table.
Planned
Provider · many

What the phrases mean

The words apps use for a feature, and the plain parts the feature is made of, in the order they happen.

Phrases left out

These phrases mean different things at different apps, so the glossary doesn't map them.

  • content marketingIt names a strategy that spans the blog, emails and social posts, not one part.
  • page builderIt means a section editor at some vendors and a full theme editor at others; sections belong to the theme category.
  • visual editorIt means a rich text toolbar at one vendor and a drag-and-drop page layout tool at another.

Sources

The app documentation these parts were checked against.