Back to Intelligence
Platform UpdatesGlobal

Shopify Catalog API adds media-type filtering for video and 3D products

The update lets apps find products with specific media and receive asset URLs in the same response, while existing queries remain unchanged.

Ecomwith EditorialEcommerce intelligence desk

Published
Updated
Risk
low

Reported details

What happened

Verified from Shopify Developer Changelog, event event:1b7e67cb92e7a98b2a4e90c1: Catalog API now exposes video and 3D model media alongside images on search_catalog, get_product, and lookup_catalog responses when those assets exist.

The new catalog.filters.media filter accepts image, video, or model_3d. Multiple entries combine with AND, so a request for video and model_3d returns products with both media types.

The filter is optional, and existing queries keep returning the same products. Matching search results include media asset URLs, reducing the need for a separate media-fetching request.

Business relevance

Why it matters

Apps that build product discovery or merchandising experiences can identify media-rich products during catalog search instead of retrieving products first and filtering them after the response.

For merchants whose products include video or 3D assets, this can make those products easier for connected shopping tools to select and render, provided the consuming app supports the returned media URLs.

The change is global in scope because the supplied marketApplicability is global, but its commercial value depends on whether a merchant's connected apps use the affected Catalog API operations.

Editorial perspective

Analysis & judgment

  1. This is primarily a workflow simplification rather than a change to storefront merchandising by itself: the API can now express media requirements at search time, while the merchant still needs usable video or 3D assets in its catalog.

  2. The AND behavior makes the filter precise but potentially restrictive. A client asking for both video and model_3d will exclude products that have only one of those formats.

  3. The update does not create media assets or guarantee that every client will display them; it exposes qualifying assets to applications that are prepared to consume the response.

Applicability

Seller impact

Merchants with catalog-connected recommendation, discovery, or agent tools may see more relevant product selection if those tools adopt media-type filtering.

Merchants without video or 3D model assets have no stated operational benefit from the new filter, although their existing catalog queries should remain unaffected.

Teams maintaining Catalog API integrations should review response handling because media arrays may now contain video and model_3d entries rather than images only.

Action plan

What to do now

  1. 1

    Audit Catalog API consumers

    this-week

    If your apps or commerce tools call search_catalog, get_product, or lookup_catalog, check whether their media parsing and rendering logic can handle video and model_3d entries and asset URLs.

  2. 2

    Test targeted catalog queries

    this-week

    If media-rich discovery matters to your assortment, test catalog.filters.media with one type first, then validate the AND behavior before using combined video and model_3d filters in production.

  3. 3

    Measure adoption before changing merchandising workflows

    monitor

    If your connected tools do not yet use the new filter, monitor their release notes or integration updates before redesigning product-selection rules around media availability.

What not to do yet

  • Do not assume that adding the filter will create video or 3D coverage for products that lack those assets, or that every connected client will automatically render the returned media.

Sources & context

Evidence and sources

A source may provide only a headline or summary. Read the evidence scope below. Links and workflow checks are not independent fact verification. Internal confidence values are workflow signals, not probabilities of factual correctness.

  1. 01

    The Catalog API now returns video and 3D model media on products that have it, and supports filtering search results by media type. You can request only products that have video or 3D model media attached, and matching products return links to those assets in the same response. The new filter is optional, and existing queries keep returning the same products. What changed 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. An unrecognized type doesn't fail the request. The API ignores it and reports it in result.messages[] with the code not_found. Products that match come back with media asset URLs, so a client can render a product without a second request to fetch its media. 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. There's no change to existing filters, no ne

    Shopify Developer Changelog · Workflow status: single-source

    Source link

    Retrieved: September 16, 2026 at 12:07 a.m. UTC

    Claim is bounded to the ingested title or summary; no source body or quotation is retained.

Related tutorials and tools

Ecomwith tutorials