Skip to main content

Standard metaobject definitions

Standard metaobject definitions are metaobject definitions with a specific type that we've reserved. Standard metaobject definitions have pre-configured access grants, a known set of metaobject fields, and preconfigured capabilities. Standards ensure interoperability across the Shopify ecosystem.

Note

The Shopify standard taxonomy is a suite of standard metaobject definitions that's used to store and manage product taxonomy categories and attributes. Learn how to integrate your app with the Shopify standard product taxonomy.

The following table lists available standard metaobject definitions:

Standard metaobject definitions
NameIDTypeDetailsFields
Product Review2product_reviewStores and manages product reviews, including ratings, review content, and associated metadata. This metaobject definition is only available to approved partners. Learn about the standard product review syndication program.
  • Rating (rating) required
  • Title (single_line_text_field)
  • Body (multi_line_text_field)
  • Submitted At (date_time) required
  • Edited At (date_time)
  • Published At (date_time)
  • Source (single_line_text_field)required
  • Author (customer_reference)
  • Author display name (single_line_text_field)
  • Order (order_reference)
  • Product (product_reference)
  • Product Variant (variant_reference)
  • Merchant Reply (multi_line_text_field)
  • Merchant Replied At (date_time)
  • Media URLs (list.url)
  • Language (language)
  • App Verification Status (single_line_text_field)

Anchor to Interacting with metaobject definitions using the GraphQL Admin APIInteracting with metaobject definitions using the GraphQL Admin API

You can interact with standard metaobject definitions using GraphQL queries or mutations:

ActionQuery or mutation
Access standard metaobject definition templatesUse the standardMetaobjectDefinitionTemplates query to access standard metaobject definition templates.
Access metaobject definitionUse the metaobjectDefinition query to access a standard metaobject definition.
Create a metaobject definitionUse the standardMetaobjectDefinitionEnable mutation to create a metaobject definition using one of the standard metaobject definition templates. To specify the template you want to use, provide the ID for the template in the format gid://shopify/StandardMetaobjectDefinitionTemplate/<id>, where id is the corresponding ID value from the table.
Delete a metaobject definitionUse the metaobjectDefinitionDelete mutation to delete a metaobject definition.
Was this page helpful?