younifyd
Menu

metafieldDefinition

Retrieves a MetafieldDefinition by its identifier. You can identify a definition using either its owner type, namespace, and key, or its global ID.

Use it in a workflow

  1. Add a step and choose the Shopify connector.
  2. Pick the metafieldDefinition action (under Metafield).
  3. Fill in the fields below, then reference the result from later steps as {{metafielddefinition.response.data}}.

Query

This is the query the action sends by default. Edit it in the step's Query field to change which fields come back.

graphql
query MetafieldDefinition($id: ID, $identifier: MetafieldDefinitionIdentifierInput) {
  metafieldDefinition(id: $id, identifier: $identifier) {
    access {
      admin
      customerAccount
      storefront
    }
    capabilities {
      adminFilterable {
        eligible
        enabled
        status
      }
      analyticsQueryable {
        eligible
        enabled
      }
      cartToOrderCopyable {
        eligible
        enabled
      }
      smartCollectionCondition {
        eligible
        enabled
      }
      uniqueValues {
        eligible
        enabled
      }
    }
    constraints {
      key
    }
    description
    id
    key
    name
    namespace
    ownerType
    pinnedPosition
    standardTemplate {
      description
      id
      key
      name
      namespace
      ownerTypes
      type {
        category
        name
        supportedValidations
        supportsDefinitionMigrations
        valueType
      }
      validations {
        name
        type
        value
      }
      visibleToStorefrontApi
    }
    type {
      category
      name
      supportedValidations {
        name
        type
      }
      supportsDefinitionMigrations
      valueType
    }
    useAsCollectionCondition
    validationStatus
    validations {
      name
      type
      value
    }
  }
}

Variables

Pass these as a JSON object in the step's Variables field.

idstring

The ID of the MetafieldDefinition to return.

identifierobject

The identifier of the MetafieldDefinition to return.

ownerTypestringrequired

One ofAPI_PERMISSIONCOMPANYCOMPANY_LOCATIONPAYMENT_CUSTOMIZATIONVALIDATIONCUSTOMERDELIVERY_CUSTOMIZATIONDRAFTORDERGIFT_CARD_TRANSACTIONTRANSFERMARKETCARTTRANSFORMCOLLECTIONMEDIA_IMAGEPRODUCTPRODUCTVARIANTSELLING_PLANARTICLEBLOGPAGEFULFILLMENT_CONSTRAINT_RULEORDER_ROUTING_LOCATION_RULEDISCOUNTORDERLOCATIONSHOP

namespacestring
keystringrequired
json
{
  "id": "string",
  "identifier": {
    "ownerType": "API_PERMISSION",
    "key": "string",
    "namespace": "string"
  }
}

Response

Read the result with {{metafielddefinition.response.data.data.metafieldDefinition}}. If the API returns errors, the step fails and they are at {{metafielddefinition.response.data.errors}}.

accessobject
adminstring

One ofPRIVATEPUBLIC_READPUBLIC_READ_WRITEMERCHANT_READMERCHANT_READ_WRITE

customerAccountstring

One ofREAD_WRITEREADNONE

storefrontstring

One ofPUBLIC_READNONE

capabilitiesobject
adminFilterableobject3 fields
analyticsQueryableobject2 fields
cartToOrderCopyableobject2 fields
smartCollectionConditionobject2 fields
uniqueValuesobject2 fields
constraintsobject
keystring
descriptionstring
idstring
keystring
namestring
namespacestring
ownerTypestring

One ofAPI_PERMISSIONCOMPANYCOMPANY_LOCATIONPAYMENT_CUSTOMIZATIONVALIDATIONCUSTOMERDELIVERY_CUSTOMIZATIONDRAFTORDERGIFT_CARD_TRANSACTIONTRANSFERMARKETCARTTRANSFORMCOLLECTIONMEDIA_IMAGEPRODUCTPRODUCTVARIANTSELLING_PLANARTICLEBLOGPAGEFULFILLMENT_CONSTRAINT_RULEORDER_ROUTING_LOCATION_RULEDISCOUNTORDERLOCATIONSHOP

pinnedPositionnumber
standardTemplateobject
descriptionstring
idstring
keystring
namestring
namespacestring
ownerTypesarray<object>
typeobject5 fields
validationsarray<object>
visibleToStorefrontApiboolean
typeobject
categorystring
namestring
supportedValidationsarray<object>
supportsDefinitionMigrationsboolean
valueTypestring

One ofSTRINGINTEGERJSON_STRINGBOOLEAN

useAsCollectionConditionboolean
validationStatusstring

One ofALL_VALIDIN_PROGRESSSOME_INVALID

validationsarray<object>
nameobject
typeobject
valueobject

Need more? See the Shopify guide for connection setup and behaviour shared by every action.