Capabilities
Capabilities provide a way to mix in behaviors and logic with your metaobjects. When you create a metaobject definition, you can enable capabilities
that provide additional behavior. You can enable the following capabilities:
- publishable: Enable drafting of metaobjects using a
status
column either set toDRAFT
orACTIVE
. - translatable: Make your metaobjects translatable through Shopify's translation APIs.
Draft custom content
Anchor link to section titled "Draft custom content"The publishable
capability enables users of your metaobject to set it's status to either DRAFT
or ACTIVE
. This can be useful for providing merchants a way to stage their content before making it available to their storefronts - even if you defined it to be available to storefronts using access controls.
In the following, the metaobjectDefinitionCreate
mutation is called with publishable
set to true
to enable this capability:
Next, using the metaobjectCreate
mutation, you'll notice that the default status for a created "Custom Article" metaobject is DRAFT
.
To publish the custom article metaobject, you can use the metaobjectUpdate
mutation and set the status to ACTIVE
.
Make your metaobjects translatable
Anchor link to section titled "Make your metaobjects translatable"The translatable
capability allows the fields of a metaobject to be translated. You can be enable this capability by setting translatable
to true
when performing a metaobjectDefinitionCreate
or metaobjectDefinitionUpdate
mutation.
Once translatable
has been enabled, you can use Shopify's translation APIs to register translations for fields on your metaobjects. For the "Custom Article" metaobject, you'll first need to retrieve the fields that can be translated through the translatableResources
query:
Then, you can register translations for any of the fields on the metaobject. For example, you can translate the title
field by passing in the metaobject ID and using the digest
for the title
field: