ytdl-org/youtube-dl · error · ExtractorError

Unsupported clip storage location "%s"

Error message

Unsupported clip storage location "%s"

What it means

Raised by ClipchampIE when the Next.js video data's 'storage_location' field is anything other than 'cf_stream'. Clipchamp stores exports on different backends (e.g. Microsoft/OneDrive-backed or pending storage); the extractor only implements retrieval from Cloudflare Stream manifests, so other locations are rejected with the actual value in the message.

Source

Thrown at youtube_dl/extractor/clipchamp.py:45

            'thumbnail': r're:^https?://.+\.jpg',
        },
        'params': {
            'skip_download': 'm3u8',
            'format': 'bestvideo',
        },
    }]

    _STREAM_URL_TMPL = 'https://%s.cloudflarestream.com/%s/manifest/video.%s'
    _STREAM_URL_QUERY = {'parentOrigin': 'https://clipchamp.com'}

    def _real_extract(self, url):
        video_id = self._match_id(url)
        webpage = self._download_webpage(url, video_id)
        data = self._search_nextjs_data(webpage, video_id)['props']['pageProps']['video']

        storage_location = data.get('storage_location')
        if storage_location != 'cf_stream':
            raise ExtractorError('Unsupported clip storage location "%s"' % (storage_location,))

        path = data['download_url']
        iframe = self._download_webpage(
            'https://iframe.cloudflarestream.com/' + path, video_id, 'Downloading player iframe')
        subdomain = self._search_regex(
            r'''\bcustomer-domain-prefix\s*=\s*("|')(?P<sd>[\w-]+)\1''', iframe,
            'subdomain', group='sd', fatal=False) or 'customer-2ut9yn3y6fta1yxe'

        formats = self._extract_mpd_formats(
            self._STREAM_URL_TMPL % (subdomain, path, 'mpd'), video_id,
            query=self._STREAM_URL_QUERY, fatal=False, mpd_id='dash')
        formats.extend(self._extract_m3u8_formats(
            self._STREAM_URL_TMPL % (subdomain, path, 'm3u8'), video_id, 'mp4',
            query=self._STREAM_URL_QUERY, fatal=False, m3u8_id='hls'))

        return merge_dicts({
            'id': video_id,
            'formats': formats,

View on GitHub (pinned to 956b8c5855)

Solutions

1. Open the clip in a browser; if it does not play there either, re-export or publish the project first.
2. If it plays, note the actual storage_location value in the error — a different backend means this extractor cannot help; use the browser's network tab to find a direct media URL.
3. Update to yt-dlp, whose Clipchamp support may cover more backends.
4. For your own projects, re-download/export directly from the Clipchamp UI.

import json, re
def storage_is_supported(html):
    m = re.search(r'<script[^>]+id="__NEXT_DATA__"[^>]*>([^<]+)</script>', html)
    if not m:
        return False
    video = json.loads(m.group(1))['props']['pageProps']['video']
    return video.get('storage_location') == 'cf_stream'

def is_cf_stream_video(video_data):
    return (
        isinstance(video_data, dict)
        and video_data.get('storage_location') == 'cf_stream'
        and bool(video_data.get('download_url'))
    )

from youtube_dl.utils import ExtractorError
try:
    ydl.extract_info(url)
except ExtractorError as e:
    if 'Unsupported clip storage location' in str(e):
        # different backend; fetch media URL manually from browser network tab
        log('storage backend %s not supported', extract_location(e))
    else:
        raise

When it happens

Trigger: Extracting a clipchamp.com video whose export was stored on a non-Cloudflare backend, or a project whose video is not fully processed/published yet (storage_location may be null or a different enum).

Common situations: Older clips created before the Cloudflare Stream backend; drafts/unprocessed exports; Microsoft-era Clipchamp storage changes.

AI-assisted analysis of ytdl-org/youtube-dl@956b8c5855 (2026-08-14). Data as JSON: /api/errors/c94b743cdd69804e. Report an issue: GitHub.