Unable to create admin filterable metafield definitions

Technical Q&A

Topic summary

A developer encountered an error when attempting to enable the admin_filterable capability for metafield definitions via the Shopify Admin API. The error message stated “The capability admin_filterable is not valid for this definition.”

Root Cause:
The capability is only supported for specific metafield data types. The original poster was using number_integer, which is not currently supported. Supported types are documented in Shopify’s help center but not prominently featured in the developer documentation.

Documentation Issues Identified:

  • The dev docs example contains typos: adminFilterStatus (unsupported) and type (not allowed in updates)
  • Supported types list is missing from key API documentation pages
  • Native searchable fields lack clear documentation

Shopify Staff Response:
Confirmed plans to expand supported types (timing TBD) and add the supported types list to the capabilities documentation page.

Additional Feature Requests:

  • Support for number_integer type with comparison operators (less than/greater than)
  • Fix for smartCollectionCondition not applying until save/reload
  • Ability to use metafield values for custom sorting

Unresolved:
Another user reported the same error with “Single line text” (supposedly supported), suggesting possible additional constraints or bugs.

Summarized with AI on October 26. AI used: claude-sonnet-4-5-20250929.
2

What definition type do you have? The admin filterable capability is only supported by a few of the types right now.

As an aside: we’ll get this list into the dev docs so it’s easier to find (and fixup those errors in the example mutation).