Metafields reference

Charlie writes safety-stock–adjusted inventory data to two metafield namespaces. Use the right one for your integration.

Which namespace to use

Integration	Namespace	Why
Themes (Liquid or Storefront API)	`app--{APP_ID}--inventory`	Variant-level fields are only here
Product feeds (GMC, Meta, Lengow, etc.)	`charlie_inventory`	Public, same key on every store
Search & Discovery filters	`charlie_inventory`	Smart collection conditions + admin filterable
Smart collections	`charlie_inventory`	Same as above
Admin API integrations (other apps)	`charlie_inventory`	Other apps can’t read app-reserved namespaces

Finding your app namespace

The app--{APP_ID}--inventory namespace is unique per store. Find your app ID once and reuse it everywhere.

Open metafield definitions

Shopify Admin → Settings → Custom data → Metafields → Variants.

Open a Charlie metafield

Click any metafield with key inventory.available or inventory.fulfillable.

Copy the namespace

Copy the full namespace, e.g. app--303723511809--inventory.

`app--{APP_ID}--inventory` (app-reserved)

Use for themes. Includes variant-level fields.

Shop

Key	Type	Value
`safety_stock_enabled`	`boolean`	Master switch. `true` when safety stock is active for this shop

Variant

Key	Type	Value
`available`	`boolean`	`true` if sellable quantity > 0 for this variant
`fulfillable`	`number_integer`	Total sellable quantity across fulfillable locations

Product

Key	Type	Value
`available`	`boolean`	`true` if any variant has sellable quantity > 0
`fulfillable`	`number_integer`	Total fulfillable across all variants
`first_available_variant`	`variant_reference`	First variant with sellable quantity > 0

`charlie_inventory` (public)

Use for feeds, filters, smart collections, and any non-theme integration. Same namespace on every store. No app ID lookup needed. Themes can read either namespace. Other apps cannot read the app--{APP_ID}--inventory (app-reserved) namespace. That’s why Charlie mirrors product-level availability to a public namespace. Anything that runs as a Shopify app (Search & Discovery, product feed apps, smart collection metafield conditions, third-party search) can only see charlie_inventory.

Product

Key	Type	Value
`available`	`boolean`	`true` if any variant has sellable quantity > 0
`fulfillable`	`number_integer`	Total fulfillable across all variants

Variant-level fields are not mirrored to charlie_inventory. For variant-level data, use the app-reserved namespace.

Access

Liquid:

{% assign is_available = product.metafields.charlie_inventory.available.value %}
{% assign sellable = product.metafields.charlie_inventory.fulfillable.value %}

Storefront API:

query ($handle: String!) {
  product(handle: $handle) {
    available: metafield(namespace: "charlie_inventory", key: "available") { value }
    fulfillable: metafield(namespace: "charlie_inventory", key: "fulfillable") { value }
  }
}

Update timing

Charlie writes both namespaces whenever Shopify sends a products/update webhook (which fires on inventory changes). Updates are queued and applied within a few seconds, max ~10 seconds.

After uninstalling Charlie

Charlie does not delete charlie_inventory.* metafield values when uninstalled. The values stay on each product so you can export or migrate the data. To remove them, delete the metafield definitions manually in Shopify Admin → Settings → Custom data → Products (look for charlie_inventory.available and charlie_inventory.fulfillable).

Theme integration

Liquid recipes for variant pickers, badges, and price display

App integrations

Wire product feeds, search, and filter apps to respect safety stock

Safety Stock

How sellable inventory is calculated

Getting started

Locations

Fulfillment constraints

Order routing

Inventory

Analytics

Settings

Metafields reference

Which namespace to use

Finding your app namespace

`app--{APP_ID}--inventory` (app-reserved)

Shop

Variant

Product

`charlie_inventory` (public)

Product

Access

Update timing

After uninstalling Charlie

Theme integration

App integrations

Safety Stock

​Which namespace to use

​Finding your app namespace

​app--{APP_ID}--inventory (app-reserved)

​Shop

​Variant

​Product

​charlie_inventory (public)

​Product

​Access

​Update timing

​After uninstalling Charlie

​Related

Theme integration

App integrations

Safety Stock

Which namespace to use

Finding your app namespace

`app--{APP_ID}--inventory` (app-reserved)

Shop

Variant

Product

`charlie_inventory` (public)

Product

Access

Update timing

After uninstalling Charlie

Related