Useful Automation/Brief
Shopify Catalog API adds media type filtering and returns video, 3D model assets
The Catalog API now returns video and 3D model media on products and supports filtering search results by media type. The new filter is optional and existing queries keep returning the same products.
The Catalog API now returns video and 3D model media on products and supports filtering search results by media type. A new optional filter, catalog.filters.media, accepts image, video, or model_3d entries that combine with AND. An unrecognized type is ignored and reported in result.messages[] with code not_found. Matching products return media asset URLs in the same response, so a client can render a product without a second request. Previously you had to request products, inspect each one for usable media, and discard products that didn't have any. The new filter replaces that pattern. The new media types require the draft version of the Shopify global Catalog extension (dev.shopify.catalog.global); without it, the media field returns images only. Filtering by media type applies to search_catalog, while asset URLs also return on get_product and lookup_catalog even without filtering.
What the reporting says
Each line below is stated by the page named above it, and only by that page.
Stated by shopify.dev
- The Catalog API now returns video and 3D model media on products that have it, and supports filtering search results by media type.
- The new filter is optional, and existing queries keep returning the same products.
- search_catalog, get_product, and lookup_catalog now return video and 3D model assets on a product's media array. Previously it carried images only.
- Catalog API search accepts a new filter, catalog.filters.media. Each entry names a media type: image, video, or model_3d.
- Entries combine with AND, so asking for video and model_3d returns only products that have both.
Our view
This change reduces a workflow step by eliminating the need to fetch and inspect products individually for media, but it requires opting into a draft extension version.
What the reporting says: The new filter is optional, existing queries keep returning the same products, and there is no change to existing filters, no new endpoint, and no migration.
Sources
- Shopify developer changelogText stored 16 September 2026 · checked 16 September 2026
Found through monitored feeds: Shopify developer changelog. A feed address is how the desk finds a story, not the evidence for it — the sources listed above are the pages the facts were taken from.
How this story was checked. Written from the 1 page listed above, stored 16 September 2026; claims checked against that stored text on 16 September 2026.
What that means
- 5 of 5 reported statements were confirmed against the page that carries them; the rest were removed rather than published.
- Figures in the text were required to appear in the stored source text: yes. Identifiers: yes.
- The check reads stored text only: no claim rests on a fresh look that did not happen.
- Where the reporting was silent, the text says so instead of filling the gap.