Sanity logosanity.ioAll Systems Operational© Sanity 2026
Change Site Theme
Sanity logo

Documentation

    • Overview
    • Platform introduction
    • Next.js quickstart
    • Nuxt.js quickstart
    • Astro quickstart
    • React Router quickstart
    • Studio quickstart
    • Build with AI
    • Content Lake
    • Functions
    • APIs and SDKs
    • Visual Editing
    • Blueprints
    • Platform management
    • Dashboard
    • Studio
    • Canvas
    • Media Library
    • App SDK
    • Content Agent
    • HTTP API
    • CLI
    • Libraries
    • Specifications
    • Changelog
    • User guides
    • Developer guides
    • Courses and certifications
    • Join the community
    • Templates
Media Library
Overview

  • Introduction
  • User guide

    Meet the library
    Asset Versions

  • Setup and development

    Studio configuration
    Media Library configuration

  • Aspects

    Create an aspect
    Add an aspect to an asset
    Query aspects
    Aspect patterns

  • Manage assets

    Importing assets (media + aspects)
    Upload an asset
    Link assets to documents
    Asset visibility
    Container URLs
    Working with video
    Migrate assets from Media Plugin

  • Reference

    HTTP API reference
    CLI reference
    Limits and usage

On this page

Media LibraryLast updated February 2, 2026

Container URLs

Container URLs provide a stable, shareable link to Media Library assets.

Container URLs provide a stable, shareable link to Media Library assets. They automatically reflect changes to an asset’s version or visibility (public or private), so you never need to update links manually. Container URLs are optimised for delivery by Sanity’s CDN and are available through both the Media Library UI and GROQ.

Copy a Container URL from the UI

  • Open Media Library from your Dashboard.
  • Select an asset to view its details in the right panel.
  • Click the ellipsis menu at the bottom of the right panel.
  • Select Copy URL > Copy asset CDN URL to copy the Container URL to your clipboard.
Loading...

Querying Container URLs

*[_type=="event"][0] {
  poster {
    "containerURL": documents::get(media).url
  }
}

Update durations

Because Container URLs are served by Sanity’s CDN, it can take some time for visibility or version changes to propagate. Updates typically appear within minutes.

On this page

  • Copy a Container URL from the UI
  • Querying Container URLs
  • Update durations
Screenshot of an asset management interface with abstract colorful thumbnails and a menu showing options to copy asset URLs.
*[_type=="event"][0] {
  poster {
    "containerURL": documents::get(media).url
  }
}
Previous

Asset visibility

Next

Working with video

Was this page helpful?