Declare metafields

Open Metafields for the app in the Developer Portal. The owner types shown match the Store API permissions your app currently requests — add a scope on Permissions first, then the resource appears here.

Each declaration becomes a live definition under app:{slug}.{key} on install. Keys must be unique per owner_type within your app. Choose human-readable Name and optional Description text; merchants see these in Store Admin metafield settings.

Declaration validates against your app's requested permissions. Materialization on a store additionally requires the merchant to have granted those scopes at install. A declaration for read_products does not appear on a store where the merchant denied product access.

Set App access (private or shared) and optional storefront, search, filter, and translation capabilities according to the type's capability matrix. These flags are part of the reviewed contract — they govern which other apps can read values and which merchant or buyer surfaces can read or edit them. Shared app access permits reads; it does not permit another app to write your definitions.