[Feature Request] Enable metafield filtering on files query (adminFilterable for FILE owner type)

GraphQL Admin API Troubleshooting
1

Context & Use Case

I’m building a multi-store Shopify app that syncs media assets across stores. To track assets reliably, I assign each file a stable unique identifier stored as a metafield (namespace: "app", key: "iid"). This iid is the only truly stable reference since file GIDs, CDN URLs, and filenames are all mutable or context-dependent.

The Problem

While it’s possible to read a metafield on a MediaImage / File when you already know its GID, it is currently impossible to query files by metafield value. The files query does not support metafield-based filtering.

This means I cannot do:

graphql

files(query: "metafields.app.iid:iid_xxx") { ... }

This capability already exists for Products, Customers, Orders, and other resources via the adminFilterable capability. Extending it to Files would bring consistency to the API.

Why This Matters

Without this, the only workarounds are:

  • Maintaining an external database mapping iid → GID, which adds infrastructure complexity and sync issues

  • Using a metaobject as an index, which is hacky, adds sync overhead, and is prone to drift

Both workarounds add complexity for what should be a simple lookup.

Request

Add support for the adminFilterable capability on the FILE / MEDIAIMAGE / GENERICFILE owner types, or otherwise enable metafield-based filtering in the files query.

I’d love to know if this is something on your radar, and whether it could realistically make it into an upcoming API release.

Thanks for your time and consideration!

2

Hi @Florian_Sahbi,

Thank you for the detailed feedback here, I will absolutely be passing this on internally, and while I can’t guarantee when or if this would be add, I can assure you that our developers and product team do take all of our partner and merchant feedback into great value when determining future features and platform changes.

Additionally, we are unable to share any info on upcoming features or roadmaps that haven’t been made public yet, but I can confirm that this request will be on our radar after submitting your feedback!

In the mean time I may recommend keeping an eye on our Shopify.dev Changelog so you can be notified if this does get added in the future.

Just for clarity and in case anyone else following along is curious, the following Shopify.dev documentation describes what resources are currently filterable via Metafields on the Admin API.

Admin filterable is available for the following resources:

  • Products
  • Companies*
  • Company Locations*
  • Metaobjects
  • Orders

*Does not support numeric and date searches at this time.

3

Thanks Kellan for the quick reply and the documentation links, that confirms what I needed to know. I’ll go with an external DB as a lookup table, works well for my use case.

Appreciate the help!