{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Image CDN","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"image-cdn","__idx":0},"children":["Image CDN"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All image URLs returned by the API are served through our CDN with automatic optimization. Images are compressed and converted to modern formats (WebP/AVIF) based on browser support."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"default-behavior","__idx":1},"children":["Default Behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Images are returned at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["original dimensions"]}," (capped at 2048px max) with automatic format conversion. Use presets to request specific sizes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"presets","__idx":2},"children":["Presets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Append a preset query parameter to any image URL for consistent sizing:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Preset"},"children":["Preset"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Dimensions"},"children":["Dimensions"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use Case"},"children":["Use Case"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["thumb"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["150×150"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Thumbnails, small icons"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["medium"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["600×600"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Listings, card images"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["large"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1200×1200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Detail views, galleries"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hero"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1920×800"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hero banners, headers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avatar"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200×200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User avatars, profile pictures"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400×300"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product cards, previews"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":3},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Original (max 2048px, auto format)\nhttps://cdn.example.com/images/photo.png\n\n# Thumbnail\nhttps://cdn.example.com/images/photo.png?preset=thumb\n\n# Medium for listings\nhttps://cdn.example.com/images/photo.png?preset=medium\n\n# High quality large\nhttps://cdn.example.com/images/photo.png?preset=large&q=95\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"query-parameters","__idx":4},"children":["Query Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preset"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resize preset (see table above)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["q"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["80"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Quality (1-100)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["f"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auto"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Output format"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inside"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resize fit mode"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"format-options--f-","__idx":5},"children":["Format Options (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["f"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auto"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Best format based on browser support (recommended)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jpeg"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Force JPEG"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Force WebP"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["png"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Force PNG (preserves transparency)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avif"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Force AVIF (best compression)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fit-options--fit-","__idx":6},"children":["Fit Options (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fit"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inside"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fit within dimensions, maintain aspect ratio (default)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cover"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cover dimensions, crop overflow"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fit within dimensions with padding"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fill"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stretch to exact dimensions"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-formats","__idx":7},"children":["Supported Formats"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Input:"]}," JPEG, PNG, WebP, GIF (animations preserved), AVIF"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output:"]}," Auto-selected based on browser support (WebP, AVIF, JPEG, PNG)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-codes","__idx":8},"children":["Error Codes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP Code"},"children":["HTTP Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Success"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Image not found"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5xx"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Processing error (falls back to original)"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Invalid parameters are clamped to valid ranges automatically."]}]}]},"headings":[{"value":"Image CDN","id":"image-cdn","depth":1},{"value":"Default Behavior","id":"default-behavior","depth":2},{"value":"Presets","id":"presets","depth":2},{"value":"Example","id":"example","depth":3},{"value":"Query Parameters","id":"query-parameters","depth":2},{"value":"Format Options ( f )","id":"format-options--f-","depth":3},{"value":"Fit Options ( fit )","id":"fit-options--fit-","depth":3},{"value":"Supported Formats","id":"supported-formats","depth":2},{"value":"Error Codes","id":"error-codes","depth":2}],"frontmatter":{"seo":{"title":"Image CDN"}},"lastModified":"2026-05-22T17:51:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/9.image-cdn","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}