{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gcore Documentation","colors":{"primary":"#ff4c00","light":"#ff4c00","dark":"#ff4c00"},"logo":{"light":"https://mintcdn.com/gcore/6eTmdOhRD-GYL1w_/logo/logo.svg?fit=max\u0026auto=format\u0026n=6eTmdOhRD-GYL1w_\u0026q=85\u0026s=d2792deb0bdf1974d7b21cdfc4b77d6a","dark":"https://mintcdn.com/gcore/6eTmdOhRD-GYL1w_/logo/logo_dark.svg?fit=max\u0026auto=format\u0026n=6eTmdOhRD-GYL1w_\u0026q=85\u0026s=3bf793eac53c8a632acfaeab3102ef5b"},"favicon":"https://mintcdn.com/gcore/hcYbfy80bZ8QhNoc/favicon.png?fit=max\u0026auto=format\u0026n=hcYbfy80bZ8QhNoc\u0026q=85\u0026s=1cc97bf7c31651c44b8fff425cff910a","appearance":{"default":"light"},"background":{"decoration":"grid","color":{"dark":"#212529"}},"navbar":{"links":[{"href":"https://gcore.com/contact-us","label":"Contact Us"}],"primary":{"type":"button","label":"Sign up for free","href":"https://auth.gcore.com/login/signup?lang=en"}},"footer":{"socials":{"instagram":"https://www.instagram.com/gcore.official","youtube":"https://www.youtube.com/@GCoreOfficial","x":"https://x.com/gcore_official","linkedin":"https://www.linkedin.com/company/g-core","discord":"https://discord.com/invite/gcore"},"links":[{"header":"Products","items":[{"label":"AI","href":"https://gcore.com/everywhere-inference"},{"label":"Cloud","href":"https://gcore.com/cloud"},{"label":"Network","href":"https://gcore.com/edge-network"},{"label":"Security","href":"https://gcore.com/ddos-protection"},{"label":"Colocation","href":"https://gcore.com/colocation"},{"label":"Pricing","href":"https://gcore.com/pricing/cloud"},{"label":"Technical Support","href":"https://gcore.com/support-as-a-service"}]},{"header":"Resources","items":[{"label":"Blog","href":"https://gcore.com/blog"},{"label":"Case Studies","href":"https://gcore.com/case-studies"},{"label":"Resource Library","href":"https://gcore.com/resources"},{"label":"Events","href":"https://gcore.com/events"},{"label":"Startups Program","href":"https://gcore.com/go/startups-apply-program"},{"label":"Product Roadmap","href":"https://roadmap.gcore.com/roadmap"},{"label":"Gcore Status","href":"https://status.gcore.com/"},{"label":"White Label Solutions","href":"https://gcore.com/whitelabel"}]},{"header":"Company","items":[{"label":"About Gcore","href":"https://gcore.com/about"},{"label":"Press","href":"https://gcore.com/press"},{"label":"Awards","href":"https://gcore.com/awards-recognition"},{"label":"Careers","href":"https://gcore.com/careers"},{"label":"Legal Information","href":"https://gcore.com/legal"},{"label":"Privacy Policy","href":"https://gcore.com/legal?tab=privacy_policy"},{"label":"Cookie Policy","href":"https://gcore.com/legal?tab=cookie_policy"},{"label":"Discord","href":"https://discord.gg/gcore"},{"label":"Infrastructure","href":"https://gcore.com/infrastructure"},{"label":"Internet Peering Points","href":"https://gcore.com/internet-peering"}]},{"header":"Contact us","items":[{"label":"sales@gcore.com","href":"mailto:sales@gcore.com"},{"label":"support@gcore.com","href":"mailto:support@gcore.com"},{"label":"info@gcore.com","href":"mailto:info@gcore.com"},{"label":"Help Center","href":"https://support.gcore.com/hc/en-us"},{"label":"Report Abuse","href":"https://abuse.gcore.com/hc/en-us/requests/new?ticket_form_id=34297484792977"}]}]},"seo":{"metatags":{"canonical":"https://docs.gcore.com"}},"integrations":{"gtm":{"tagId":"GTM-PXQB4BG"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"user","href":"https://docs.gcore.com/"},{"anchor":"Gcore Status","icon":"waveform","href":"https://status.gcore.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gcore","hasAudioNarration":false,"actualSubdomain":"gcore","customDomains":["docs.gcore.com"],"gitSource":{"type":"github","owner":"g-core","repo":"product-documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0148e40d13a27bf2840018","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":1340},{"language":"default","tag":"Documentation","count":601},{"language":"default","tag":"Cloud","count":598},{"language":"default","tag":"CDN","count":284},{"language":"default","tag":"WAAP","count":195},{"language":"default","tag":"Resellers","count":171},{"language":"default","tag":"Edge Cloud","count":105},{"language":"default","tag":"FastEdge","count":103},{"language":"default","tag":"Streaming","count":93},{"language":"default","tag":"Video Streaming","count":83}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 300 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh0NSDulI.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 300 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh2dSDulI.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 300 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh0dSDulI.woff2) format('woff2');\n unicode-range: U+1F00-1FFF;\n}\n/* greek */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 300 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh3tSDulI.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 300 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bhZ_Wmh2uX.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 300 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh09SDulI.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Fira Code';\n font-style: normal;\n font-weight: 300 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/firacode/v27/uU9NCBsR6Z2vfE9aq3bh3dSD.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Montserrat';\n font-style: italic;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUQjIg1_i6t8kCHKm459WxRxC7mw9c.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Montserrat';\n font-style: italic;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUQjIg1_i6t8kCHKm459WxRzS7mw9c.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Montserrat';\n font-style: italic;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUQjIg1_i6t8kCHKm459WxRxi7mw9c.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Montserrat';\n font-style: italic;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUQjIg1_i6t8kCHKm459WxRxy7mw9c.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Montserrat';\n font-style: italic;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUQjIg1_i6t8kCHKm459WxRyS7m.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Montserrat';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUSjIg1_i6t8kCHKm459WRhyzbi.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Montserrat';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUSjIg1_i6t8kCHKm459W1hyzbi.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Montserrat';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUSjIg1_i6t8kCHKm459WZhyzbi.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Montserrat';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUSjIg1_i6t8kCHKm459Wdhyzbi.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Montserrat';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/montserrat/v31/JTUSjIg1_i6t8kCHKm459Wlhyw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--font-family-body-custom: \"Montserrat\";--font-family-headings-custom: \"Montserrat\";--font-jetbrains-mono: \"Fira Code\"}.relative.mt-8.prose.prose-gray a{color:#ff4c00}.danger-admonition{border:1px solid rgba(239, 68, 68, 0.2);background-color:rgba(254, 242, 242, 0.5)}.dark\\:danger-admonition:is(.dark *){border-color:rgba(239, 68, 68, 0.3);background-color:rgba(239, 68, 68, 0.1)}.tabs{border:1px solid rgb(var(--gray-200))}.tabs ul.not-prose.mb-6 li button{padding:12px 12px 10px}.tabs div.prose.overflow-x-auto{margin-left:0;padding:0 12px 12px}.homepage_wrapper{width:75%;max-width:1440px;margin:50px auto;padding:0 26px}.gcore_hero{margin-bottom:64px}.homepage_wrapper .gcore_hero{margin-bottom:2rem;display:flex!important;flex-direction:column!important;align-items:center!important}.homepage_wrapper .gcore_hero .gcore_hero_inner{align-items:center!important;text-align:center!important}.homepage_wrapper .gcore_hero .gcore_hero_title,.homepage_wrapper .gcore_hero .gcore_hero_subtitle{text-align:center!important;margin-left:auto!important;margin-right:auto!important}section.gcore_hero.not-prose h1.gcore_hero_title,.homepage_wrapper .gcore_hero h1.gcore_hero_title{font-size:clamp(1.875rem, 1.4rem + 1.5vw, 2.1875rem)!important;line-height:1.2!important}section.gcore_hero.not-prose .gcore_hero_subtitle,.homepage_wrapper .gcore_hero .gcore_hero_subtitle{display:block!important;width:100%!important;max-width:42rem!important;font-size:0.75rem!important;line-height:1.4!important}.homepage_wrapper .homepage_help{margin-top:2rem!important}.homepage_wrapper .homepage_help_separator{border-top:1px solid rgb(229 231 235)!important;margin:0 0 1.25rem!important}.dark .homepage_wrapper .homepage_help_separator{border-color:rgb(55 65 81)!important}.homepage_wrapper .homepage_help_inner{display:flex!important;flex-wrap:wrap!important;align-items:center!important;justify-content:space-between!important;gap:1rem 1.5rem!important}.homepage_wrapper .homepage_help_text{margin:0!important;flex:1 1 12rem!important;max-width:36rem!important;font-size:0.75rem!important;line-height:1.4!important;color:rgb(41 37 36)!important}.dark .homepage_wrapper .homepage_help_text{color:rgb(231 229 228)!important}.homepage_wrapper .homepage_help_lead{font-weight:700!important;color:#ff4c00!important}.homepage_wrapper .homepage_help_actions{display:flex!important;flex-wrap:wrap!important;align-items:center!important;justify-content:flex-end!important;gap:0.5rem!important;flex:1 1 auto!important}.homepage_wrapper .homepage_help_button{display:inline-flex!important;align-items:center!important;justify-content:center!important;padding:0.4rem 0.75rem!important;font-size:0.75rem!important;line-height:1.4!important;font-weight:500!important;border:1px solid rgb(228 228 231)!important;border-radius:0.375rem!important;color:rgb(41 37 36)!important;text-decoration:none!important;transition:border-color 0.15s ease,\n color 0.15s ease,\n background-color 0.15s ease!important}.dark .homepage_wrapper .homepage_help_button{border-color:rgb(63 63 70)!important;color:rgb(231 229 228)!important}@media (hover: hover) and (pointer: fine){.homepage_wrapper .homepage_help_button:hover{border-color:#ff4c00!important;color:#ff4c00!important}}.homepage_wrapper .homepage_help_button:focus-visible{outline:2px solid #ff4c00!important;outline-offset:2px!important}@media (max-width: 639px){.homepage_wrapper .homepage_help_inner{flex-direction:column!important;align-items:stretch!important;justify-content:flex-start!important;gap:0.75rem!important}.homepage_wrapper .homepage_help_text{flex:0 1 auto!important;max-width:none!important}.homepage_wrapper .homepage_help_actions{flex:0 1 auto!important;justify-content:flex-start!important}.homepage_wrapper .homepage_help_button{width:100%!important;box-sizing:border-box!important}}.homepage_wrapper .card-group{gap:0.75rem!important;align-items:stretch!important}.homepage_wrapper .homepage_account_bar{margin-top:1.75rem!important}.homepage_wrapper .homepage_product_cards{margin-top:1.5rem!important}.homepage_wrapper .homepage_explore_products_heading{margin:0 0 0.75rem!important;padding:0!important;width:100%!important;text-align:left!important;font-size:0.75rem!important;line-height:1.4!important;font-weight:700!important;letter-spacing:0.04em!important;text-transform:uppercase!important;color:rgb(41 37 36)!important}.dark .homepage_wrapper .homepage_explore_products_heading{color:rgb(231 229 228)!important}.homepage_wrapper .card-group .card{border-radius:0.5rem;--homepage-card-icon-size: 1.25rem;--homepage-card-icon-gap: 0.5rem;display:flex!important;flex-direction:column!important;height:100%!important;min-height:0!important}.homepage_wrapper .card-group .card>a,.homepage_wrapper .card-group .card>div:not(.card-arrow){flex:1 1 auto!important;align-self:stretch!important;width:100%!important;min-height:0!important;padding:2rem 1.5rem!important;gap:0.375rem!important;box-sizing:border-box!important;border:1px solid transparent!important;border-radius:0.5rem!important;transition:border-color 0.2s ease, background-color 0.2s ease!important;touch-action:manipulation!important;-webkit-tap-highlight-color:rgba(255, 76, 0, 0.12)!important}@media (hover: hover) and (pointer: fine){.homepage_wrapper .card-group .card:hover>a,.homepage_wrapper .card-group .card:hover>div:not(.card-arrow){border-color:#ff4c00!important;background-color:rgba(255, 76, 0, 0.06)!important}.dark .homepage_wrapper .card-group .card:hover>a,.dark .homepage_wrapper .card-group .card:hover>div:not(.card-arrow){background-color:rgba(255, 76, 0, 0.12)!important}}.homepage_wrapper .card-group .card:focus-within>a,.homepage_wrapper .card-group .card:focus-within>div:not(.card-arrow){border-color:#ff4c00!important;background-color:rgba(255, 76, 0, 0.06)!important}.dark .homepage_wrapper .card-group .card:focus-within>a,.dark .homepage_wrapper .card-group .card:focus-within>div:not(.card-arrow){background-color:rgba(255, 76, 0, 0.12)!important}@media (prefers-reduced-motion: reduce){.homepage_wrapper .card-group .card>a,.homepage_wrapper .card-group .card>div:not(.card-arrow){transition:none!important}}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"]{display:grid!important;grid-template-columns:auto minmax(0, 1fr)!important;grid-template-rows:auto auto!important;column-gap:var(--homepage-card-icon-gap)!important;row-gap:0.35rem!important;align-items:start!important;width:100%!important;min-width:0!important;box-sizing:border-box!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"]>:first-child{grid-column:1!important;grid-row:1!important;align-self:start!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"]>:nth-child(2){display:contents!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"] [data-component-part=\"card-title\"]{grid-column:2!important;grid-row:1!important;min-width:0!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"] [data-component-part=\"card-content\"]{grid-row:2!important;min-width:0!important;padding-inline:0!important;margin-inline-start:calc(-1 * (var(--homepage-card-icon-size) + var(--homepage-card-icon-gap)))!important;width:calc(100% + var(--homepage-card-icon-size) + var(--homepage-card-icon-gap))!important;max-width:none!important;box-sizing:border-box!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"]>[data-component-part=\"card-title\"]~[data-component-part=\"card-content\"]{grid-column:1 / -1!important;margin-inline-start:0!important;width:100%!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"]>h2{grid-column:2!important;grid-row:1!important;min-width:0!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"]>p{grid-row:2!important;padding-inline:0!important;margin-inline-start:calc(-1 * (var(--homepage-card-icon-size) + var(--homepage-card-icon-gap)))!important;width:calc(100% + var(--homepage-card-icon-size) + var(--homepage-card-icon-gap))!important;max-width:none!important;box-sizing:border-box!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content-container\"]>h2~p{grid-column:1 / -1!important;margin-inline-start:0!important;width:100%!important}.homepage_wrapper .card-group .card h2,.homepage_wrapper .card-group .card [data-component-part=\"card-title\"] h2{font-size:1rem!important;font-weight:600!important;line-height:1.25!important;margin:0!important;min-height:calc(2 * 1.25em)!important;max-height:calc(2 * 1.25em)!important;overflow:hidden!important;display:-webkit-box!important;-webkit-box-orient:vertical!important;-webkit-line-clamp:2!important;line-clamp:2!important;box-sizing:border-box!important}.homepage_wrapper .card-group .card img{width:1.25rem!important;height:1.25rem!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content\"],.homepage_wrapper .card-group .card [data-component-part=\"card-content\"] .prose{font-size:0.75rem!important;line-height:1.4!important;min-height:calc(2 * 0.75rem * 1.4)!important;max-height:calc(2 * 0.75rem * 1.4)!important;overflow:hidden!important;padding-inline:0!important;max-width:none!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content\"] p,.homepage_wrapper .card-group .card [data-component-part=\"card-content\"] .prose p,.homepage_wrapper .card-group .card p,.homepage_wrapper .card-group .card .prose p{font-size:0.75rem!important;line-height:1.4!important;font-weight:400!important;margin:0!important;padding-inline-start:0!important;text-indent:0!important;display:-webkit-box!important;-webkit-box-orient:vertical!important;-webkit-line-clamp:2!important;overflow:hidden!important}.homepage_wrapper .card-group .card p:last-of-type{margin-bottom:0!important}.homepage_wrapper .card-group .card ul,.homepage_wrapper .card-group .card .prose ul{margin:0.25rem 0 0!important;padding-left:1rem!important;font-size:0.75rem!important;line-height:1.35!important}.homepage_wrapper .card-group .card li,.homepage_wrapper .card-group .card .prose li{margin-top:0.125rem!important;margin-bottom:0!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content\"] a{color:rgb(41 37 36)!important;text-decoration:none!important}.dark .homepage_wrapper .card-group .card [data-component-part=\"card-content\"] a{color:rgb(231 229 228)!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content\"] a:hover{color:#ff4c00!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content\"] a:focus-visible{outline:2px solid #ff4c00;outline-offset:2px;border-radius:2px}.gcore-title{font-size:4.5rem;font-weight:600;margin:0;line-height:105%;letter-spacing:-1px}@media (min-width: 640px) and (max-width: 1024px){.gcore-title{font-size:3rem!important}.homepage_wrapper{width:90%!important;padding:0 1rem!important}.gcore_hero{margin-bottom:2rem!important}}@media (max-width: 639px){.homepage_wrapper .card-group{grid-template-columns:repeat(2, 1fr)!important;gap:0.5rem!important}.homepage_wrapper .card-group .card [data-component-part=\"card-content\"],.homepage_wrapper .card-group .card [data-component-part=\"card-content\"] .prose{min-height:calc(3 * 0.75rem * 1.4)!important;max-height:calc(3 * 0.75rem * 1.4)!important}.homepage_wrapper .card-group .card p,.homepage_wrapper .card-group .card .prose p{-webkit-line-clamp:3!important}.homepage_wrapper .card-group .card>a,.homepage_wrapper .card-group .card>div:not(.card-arrow){padding:1.25rem 1rem!important;gap:0.375rem!important}.homepage_wrapper .card-group .card h2,.homepage_wrapper .card-group .card [data-component-part=\"card-title\"] h2{font-size:1rem!important;line-height:1.2!important;min-height:calc(2 * 1.2em)!important;max-height:calc(2 * 1.2em)!important}.homepage_wrapper .card-group .card svg,.homepage_wrapper .card-group .card img{width:1.125rem!important;height:1.125rem!important}.homepage_wrapper .card-group .card{--homepage-card-icon-size: 1.125rem}.homepage_wrapper{width:100%!important;padding:0 1rem!important;margin:1.5rem auto!important}.gcore-title{font-size:2rem!important}.gcore_hero{margin-bottom:1.5rem!important}}#content-area:not(:has([id^=\"api-playground\"])) #header>div.mt-2{display:none}#content-area:has(.whats-new-list) #header{margin-bottom:1rem}#content-area:has(.whats-new-list) #header h1{font-size:1.65rem;line-height:1.2;margin-bottom:0.15rem}.prose .whats-new-list{border-top:1px solid #e5e7eb;margin-top:0.75rem;padding-top:1rem}.prose .whats-new-list:not(:has(.whats-new-item)){border-top:0;margin-top:0;padding-top:0}.dark .prose .whats-new-list,.dark .whats-new-list .whats-new-item{border-color:#374151}.prose .whats-new-list p.whats-new-month{margin:0 0 1rem!important;font-size:18px!important;font-weight:600!important;line-height:1.35!important}.prose .whats-new-item+p.whats-new-month{margin-top:1.75rem!important}.prose .whats-new-item{padding:1.15rem 0 1.15rem;border-bottom:1px solid #e5e7eb}.prose .whats-new-meta{display:grid;grid-template-columns:4.75rem minmax(0, 1fr);align-items:center;column-gap:0.5rem;margin:0 0 0.7rem!important;line-height:1.4!important}.prose .whats-new-badge{display:inline-flex;justify-content:center;width:fit-content;align-items:center;border-radius:999px;padding:0.02rem 0.38rem;font-size:11px;font-weight:600;line-height:1.45;letter-spacing:0}.prose .whats-new-badge-new{color:#15803d;background:#dcfce7}.prose .whats-new-badge-improved{color:#4b5563;background:#f3f4f6}.prose .whats-new-badge-fixed{color:#1d4ed8;background:#dbeafe}.dark .prose .whats-new-badge-new{color:#86efac;background:rgba(22, 163, 74, 0.18)}.dark .prose .whats-new-badge-improved{color:#d1d5db;background:rgba(156, 163, 175, 0.16)}.dark .prose .whats-new-badge-fixed{color:#93c5fd;background:rgba(37, 99, 235, 0.18)}.prose .whats-new-meta .whats-new-title{margin:0!important;font-family:inherit;font-size:15.5px!important;font-weight:650!important;line-height:1.45!important}.prose .whats-new-body{margin:0!important;font-family:inherit;font-size:14px!important;font-weight:400;line-height:1.7!important}.prose .whats-new-body code{font-family:inherit;font-size:0.95em;font-weight:600;line-height:inherit;padding:0;background:none;border:0;color:inherit}.prose .whats-new-more{margin:0.55rem 0 0!important;line-height:1.5!important}.prose .whats-new-more a{font-size:13px;font-weight:500;white-space:nowrap}.prose .whats-new-more a::before{content:\"\\2197\";display:inline-block;margin-right:0.22em;font-size:0.85em;line-height:1}#fastedge-agent-setup{box-sizing:border-box;width:100%;margin:0.85rem 0 0;padding:0.75rem 0 0;border:0;border-top:1px solid rgb(var(--gray-200));font-size:12px;line-height:1.3}#fastedge-agent-setup .fastedge-agent-setup-title{width:0;min-width:100%;margin:0 0 6px;font-size:16px;font-weight:600;line-height:1.2;white-space:nowrap}#fastedge-agent-setup .fastedge-agent-setup-cluster{display:inline-flex;flex-direction:column;align-items:stretch;width:max-content;max-width:100%}#fastedge-agent-setup .fastedge-agent-setup-agents{display:grid;grid-template-columns:repeat(5, minmax(0, 1fr));gap:6px;width:100%}#fastedge-agent-setup .fastedge-agent-setup-actions{display:flex;flex-wrap:wrap;align-items:center;gap:6px;margin-top:11px}#fastedge-agent-setup .fastedge-agent-setup-agent,#fastedge-agent-setup .fastedge-agent-setup-copy,#fastedge-agent-setup .fastedge-agent-setup-steps{margin:0;font:inherit;line-height:1}#fastedge-agent-setup .fastedge-agent-setup-agent{display:flex;align-items:center;justify-content:center;box-sizing:border-box;width:100%;height:auto;aspect-ratio:1;min-width:0;padding:0;border:1px solid rgb(var(--gray-200));border-radius:8px;background:transparent;color:inherit}#fastedge-agent-setup .fastedge-agent-setup-agent svg{display:block;width:20px;height:20px}#fastedge-agent-setup .fastedge-agent-setup-agent[data-agent=\"claude\"] svg{width:22px;height:22px}#fastedge-agent-setup .fastedge-agent-setup-agent[data-agent=\"codex\"] svg{width:18px;height:18px}#fastedge-agent-setup .fastedge-agent-setup-agent[data-agent=\"cursor\"] svg{width:19px;height:19px}#fastedge-agent-setup .fastedge-agent-setup-agent[data-agent=\"other\"] svg{width:19px;height:19px}#fastedge-agent-setup .fastedge-agent-setup-copy,#fastedge-agent-setup .fastedge-agent-setup-steps{display:inline-flex;align-items:center;justify-content:center;box-sizing:border-box;height:32px;padding:0 0.7rem;border-radius:8px;font-size:12px;font-weight:500;text-decoration:none;cursor:pointer}#fastedge-agent-setup .fastedge-agent-setup-steps{gap:0.3rem}#fastedge-agent-setup .fastedge-agent-setup-steps svg{display:block;flex:0 0 auto}#fastedge-agent-setup .fastedge-agent-setup-copy{border:0;background:#ff4c00;color:#fff}#fastedge-agent-setup .fastedge-agent-setup-steps{border:1px solid rgb(var(--gray-200));background:transparent;color:inherit}.fastedge-agent-setup-tip{position:fixed;z-index:80;box-sizing:border-box;width:200px;margin:0;padding:8px 10px;border:1px solid rgb(var(--gray-200, 229 231 235));border-radius:8px;background:#fff;color:rgb(41 37 36);font-size:12px;font-weight:400;line-height:1.45;text-align:left;white-space:normal;pointer-events:none}.dark .fastedge-agent-setup-tip{border-color:rgb(63 63 70);background:#212529;color:rgb(231 229 228)}.prose td code{overflow-wrap:normal;word-break:normal}.prose td code.token{white-space:nowrap}.method-section{position:relative}[data-method-switch]>.method-section~.method-section{display:none}.method-section>.method-name{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0}.gcore-discord-banner{position:relative;display:block;margin-top:2.5rem;margin-bottom:2.5rem;line-height:0;container-type:inline-size}.gcore-discord-banner img{width:100%;max-width:100%;height:auto;margin:0;border-radius:12px}.gcore-discord-banner__button{position:absolute;left:6.8587%;top:67%;width:34.3621%;height:18.3502%;display:flex;align-items:center;justify-content:center;box-sizing:border-box;border-radius:999px;background:linear-gradient(180deg, #ff9a70 0%, #ff4c00 32%, #ff4c00 70%, #ffbc9f 100%);color:#fff;font-family:Montserrat, sans-serif;font-size:2.75cqi;font-weight:700;line-height:1;letter-spacing:-0.01em;text-decoration:none;white-space:nowrap;cursor:pointer;transform-origin:center;transition:transform 0.08s ease, box-shadow 0.08s ease}.gcore-discord-banner__button:hover{animation:gcore-discord-nudge 0.42s ease;animation-fill-mode:forwards;box-shadow:0 8px 16px rgba(30, 18, 36, 0.28);color:#fff;text-decoration:none}.gcore-discord-banner__button:active{animation:none;transform:translateY(2px) scale(0.97);box-shadow:0 1px 2px rgba(30, 18, 36, 0.2);color:#fff}.gcore-discord-banner__button:focus-visible{outline:2px solid #fff;outline-offset:3px}@keyframes gcore-discord-nudge{0%{transform:translateY(0) rotate(0deg)}28%{transform:translateY(-4px) rotate(-1.2deg)}52%{transform:translateY(-1px) rotate(0.8deg)}74%{transform:translateY(-3px) rotate(-0.3deg)}100%{transform:translateY(-2px) rotate(0deg)}}@media (prefers-reduced-motion: reduce){.gcore-discord-banner__button:hover,.gcore-discord-banner__button:active{animation:none;transform:none}}"}]}
{"page":{"pagePath":"cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images","slug":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images","pageMetadata":{"title":"Crop images","sidebarTitle":"Crop","description":"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.","href":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const MethodSection=({id,label,children})=>{return _jsxs(`div`,{className:`method-section`,\"data-method\":id,\"data-label\":label,children:[_jsx(`p`,{className:`method-name`,children:`## `+label}),children]})};const MethodSwitch=({children})=>{const tabs=React.Children.toArray(children).map(child=>{if(!child||!child.props)return null;if(child.props.id)return child;const inner=child.props.children;if(inner\u0026\u0026inner.props\u0026\u0026inner.props.id)return inner;return null}).filter(Boolean);const firstId=tabs.length>0?tabs[0].props.id:``;const[active,setActive]=React.useState(firstId);React.useEffect(()=>{try{const saved=localStorage.getItem(`gcore_docs_method`);if(saved\u0026\u0026tabs.find(tab=>tab.props.id===saved)){setActive(saved)}}catch(_){}},[]);React.useEffect(()=>{try{document.querySelectorAll(`[data-method-switch] .method-section`).forEach(section=>{section.style.display=section.getAttribute(`data-method`)===active?`block`:`none`});document.querySelectorAll(`h2[id], h3[id]`).forEach(heading=>{const visible=heading.offsetParent!==null;document.querySelectorAll(`a[href=\"#${heading.id}\"]`).forEach(link=>{if(link.closest(`h1,h2,h3,h4,h5,h6`))return;const li=link.closest(`li`);if(li)li.style.display=visible?``:`none`})})}catch(_){}window.dispatchEvent(new Event(`scroll`))},[active]);const handleClick=id=>{setActive(id);try{localStorage.setItem(`gcore_docs_method`,id)}catch(_){}};return _jsxs(`div`,{\"data-method-switch\":``,children:[_jsx(`div`,{className:`not-prose mint-flex mint-gap-0 mint-border-b mint-border-zinc-200 dark:mint-border-zinc-800 mint-mb-8 mint-mt-2`,role:`tablist`,children:tabs.map(tab=>{const isActive=active===tab.props.id;return _jsx(`button`,{role:`tab`,\"aria-selected\":isActive,onClick:()=>handleClick(tab.props.id),className:[`mint-px-4 mint-py-2 mint-text-sm mint-font-medium mint-border-b-2 mint--mb-px mint-transition-colors mint-cursor-pointer`,isActive?`border-primary text-primary`:`mint-border-transparent mint-text-zinc-500 hover:mint-text-zinc-800 dark:hover:mint-text-zinc-200`].join(` `),children:tab.props.label},tab.props.id)})}),children]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,Info,OptimizedImage,Tab,Tabs,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsx(_MdxComponentBoundary,{name:`MethodSwitch`,children:_jsxs(MethodSwitch,{children:[_jsx(_MdxComponentBoundary,{name:`MethodSection`,children:_jsxs(MethodSection,{id:`portal`,label:`Customer Portal`,children:[_jsxs(`p`,{children:[`Crop is a feature that trims original JPG or PNG images before delivery over the CDN. Add `,_jsx(_components.a,{href:`#crop-parameters`,children:`crop\\xA0query\\xA0parameters`}),` to image URLs in the website source code to specify the target area and its location. When a user requests a webpage, the CDN returns it with cropped images.`]}),_jsx(`p`,{children:`An origin server hosts a 750×1150 px image. With Crop configured, the CDN delivers a 500×400 cropped version to end users while the original 750×1150 image remains on the origin.`}),_jsxs(Tabs,{children:[_jsx(Tab,{title:`Original image`,id:`original-image`,children:_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png?fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=66b5968f11e21cc8280e4a5cad32b7c1`,alt:`Original image`,\"data-og-width\":`768`,width:`768`,\"data-og-height\":`1152`,height:`1152`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png?w=280\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=7cadb2b1d62213e4f5a9623a990022cc 280w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png?w=560\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=75edbfba48436b87a77c7e765b1a5a91 560w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png?w=840\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=d010af1277aa5cd5b0addbf9323f6078 840w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png?w=1100\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=9dfcc198ebb7c95a42281dc82ace5919 1100w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png?w=1650\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=1c67b6decdff074ff7319fe443c8324a 1650w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483026961.png?w=2500\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=f6f6dc7094923d5b243f8ebc30a43cf8 2500w`})})}),_jsx(Tab,{title:`Cropped image`,id:`cropped-image`,children:_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=76156cdd172ffec5ace3c7ea72f1fb78`,alt:`Cropped image`,\"data-og-width\":`500`,width:`500`,\"data-og-height\":`400`,height:`400`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=3a05356d52f6f12a1ee4f5870120d2eb 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=6e634dda413ae7155fa6a4a411185d61 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=69be4179e3a51812f1bf854c1142eff9 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=dec642e17b95629b439ecb3051f9c532 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=868bed8d9a9ee6ba7b94d2078077f0f9 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483001489.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a8904206d0354d896edb24bc79a979ba 2500w`})})})]}),_jsx(Heading,{level:`2`,id:`enable-the-crop-feature`,children:`Enable the crop feature`}),_jsxs(`p`,{children:[`Crop is part of the paid Image Stack option. Image Stack also supports converting images to WebP or AVIF, resizing, and adjusting quality. To use Crop, activate Image Stack with the `,_jsx(_components.a,{href:`/cdn/cdn-resource-options/image-optimization-paid/enable-image-stack`,children:`Enable\\xA0Image\\xA0Stack`}),` guide.`]}),_jsx(Heading,{level:`2`,id:`use-crop`,children:`Use crop`}),_jsx(`p`,{children:`1. Open the website source code.`}),_jsx(`p`,{children:`2. Find the strings with the URLs of the images to crop.`}),_jsx(`p`,{children:`3. Add the query strings to the URLs of the images as follows:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?parameter=values `})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(`p`,{children:[`where `,_jsx(_components.code,{children:`image.jpg`}),` is the image URL on the website. The `,_jsx(_components.a,{href:`#crop-parameters`,children:`Crop\\xA0parameters`}),` section lists all available parameters.`]}),_jsx(`p`,{children:`4. Save the changes in the website source code.`}),_jsx(`p`,{children:`After saving, the CDN delivers cropped images to users requesting the webpage.`}),_jsx(Heading,{level:`2`,id:`crop-parameters`,children:`Crop parameters`}),_jsx(`p`,{children:`Crop cuts out a section of an original image for delivery to users. Append a query string to the image URL to specify the target area and its location.`}),_jsx(Heading,{level:`3`,id:`crop-an-image-by-customizing-its-aspect-ratio`,children:`Crop an image by customizing its aspect ratio`}),_jsxs(`p`,{children:[_jsx(_components.strong,{children:`Parameter:`}),` `,_jsx(_components.code,{children:`?crop=16:9`})]}),_jsx(`p`,{children:`where:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`16`}),` = the width component of the target aspect ratio`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`9`}),` = the height component of the target aspect ratio`]}),`\n`]}),_jsx(`p`,{children:`The tool crops an image evenly to fit the specified aspect ratio.`}),_jsx(`p`,{children:`An origin server hosts a 400×300 image with a 4:3 aspect ratio. To illustrate this, a grid has been placed on the picture.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=1e207d5371b82a83b322c32dedd4887f`,alt:`Crop an image by customizing its aspect ratio`,\"data-og-width\":`441`,width:`441`,\"data-og-height\":`349`,height:`349`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=7986fea2aef7a18fbdc3208e0b726233 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=cc1fe7cabf1193cfc0cb284f0b8b16af 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=8f348f27ed048b23cd465dea4645e7c4 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=9ff6ba19bb27786066c983191d097cd3 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=3ab6e83c396412aa97d1f189069cfd8d 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474366609.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=da0017d40b51405cf30a4326aa972e9c 2500w`})}),_jsx(`p`,{children:`Set a new aspect ratio (4:5) by adding the query parameter to the image URL:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`img.jpg?crop=4:5`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(`p`,{children:`The tool selects a section with this aspect ratio at the center of the original image.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=8cd9a0bab5b4deea732a43c210f6d28d`,alt:`Crop an image by customizing its aspect ratio`,\"data-og-width\":`466`,width:`466`,\"data-og-height\":`355`,height:`355`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=c7a7d44ef010b63db5a6d0537f33f024 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=81b688c711c09e6c0ee57f6bd8a58a4f 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=ea02c8c9abf7b23e4f3edd854bb6beb2 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=10bdd424663d42759ce59f35e58881f1 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=87e145bf93ad9fc1844a594e3059777d 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474389521.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=6b7b5db382aa88a62aac20ae6ca4e01f 2500w`})}),_jsx(`p`,{children:`Then it cuts off the unwanted parts. The resulting image looks as follows:`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png?fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=cfc82b5a4dfdef73482c95973e5012c7`,alt:`Crop an image by customizing its aspect ratio`,\"data-og-width\":`360`,width:`360`,\"data-og-height\":`600`,height:`600`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png?w=280\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=d5d7b3b6af581a5981d92eac054a4ac5 280w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png?w=560\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=9c78aad8d008bf19cac94fca8d68d7eb 560w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png?w=840\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=bcaeb81a6c03ad6becc063bc86955c66 840w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png?w=1100\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=64f8395c9fc518290e1c5e44a49c8ba2 1100w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png?w=1650\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=671ee7cd6158f85d66a6ef544c87ce1a 1650w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483306129.png?w=2500\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=7239aaec948ec13448f69e51e5e529e0 2500w`})}),_jsx(`p`,{children:`How the tool defines what to crop:`}),_jsx(`p`,{children:`It compares the values in the aspect ratio (4 and 5) and chooses the greater one (5). This determines which side of the original image is not cropped. The value 5 corresponds to the height, so the height remains the same: 300 px.`}),_jsx(`p`,{children:`It calculates the width to fit the aspect ratio by multiplying the original height by the ratio of 4:5: 300 × (4/5) = 240 px.`}),_jsx(`p`,{children:`It places a 240×300 area at the center of the original image and crops it.`}),_jsx(Heading,{level:`3`,id:`crop-an-image-at-its-center`,children:`Crop an image at its center`}),_jsxs(`p`,{children:[_jsx(_components.strong,{children:`Parameter:`}),` `,_jsx(_components.code,{children:`?crop=300,200`})]}),_jsx(`p`,{children:`where:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`300`}),` = the target width`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`200`}),` = the target height`]}),`\n`]}),_jsx(`p`,{children:`The tool keeps the target area at the center and cuts off the unwanted parts.`}),_jsx(`p`,{children:`An origin server hosts a 400×300 image. To keep only a 200×100 section at the center, add the desired parameter to the image URL:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`img.jpg?crop=200,100`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=42c32aac9a2ed6fc1f33cdeffbd1caf1`,alt:`Crop an image at its center`,\"data-og-width\":`534`,width:`534`,\"data-og-height\":`367`,height:`367`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=d238b3c44ee55b8ad6be6fb8d6118dae 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=11319673d6f4841fddaf348fdefeb32f 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=ce90b0b8821454ca5ab45dd4dbde23b3 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=f6be0064a7bdd3ed06462bf80cc9616a 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=4826aae4a2813589d22c242c8d310e3b 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483307409.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=f398f6e002016280e020591c02cfdb7f 2500w`})}),_jsx(`p`,{children:`The tool crops a 200×100 area from the center. The resulting image looks as follows:`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=71ce019a1fe3a17c3e186cf821bc7ee4`,alt:`Crop an image at its center`,\"data-og-width\":`200`,width:`200`,\"data-og-height\":`100`,height:`100`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=ce2e1666d9a638673bf494b2ff69e5ef 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=998b6456b3c34edb9a4de082ddc58d8b 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=7445ced8935be18578fb0e87b3864608 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=be73b88c27097cc71bf4431b369cac16 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=4e68f2acd4148435591548071383e67d 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483406225.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=da1c3b9cebbab72160010c6ee85600f1 2500w`})}),_jsx(Heading,{level:`3`,id:`crop-from-a-specific-location`,children:`Crop from a specific location`}),_jsxs(`p`,{children:[`To cut out a section from a specific location, add the target width and height parameters (`,_jsx(_components.code,{children:`?crop=(width),(height)`}),`) and then the location of the section. The location can be specified in four ways, described in the subsections below.`]}),_jsx(Heading,{level:`4`,id:`specify-a-location-with-two-offsets-measured-in-pixels`,children:`Specify a location with two offsets measured in pixels`}),_jsxs(`p`,{children:[_jsx(_components.strong,{children:`Parameter:`}),` `,_jsx(_components.code,{children:`?crop=300,200,x100,y50`})]}),_jsx(`p`,{children:`where:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`300`}),` = the target width`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`200`}),` = the target height`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`100`}),` = the number of pixels to offset from the original left side`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`50`}),` = the number of pixels to offset from the original top`]}),`\n`]}),_jsx(`p`,{children:`The tool positions the target area so that its upper-left corner is at the specified coordinate, then cuts out the section.`}),_jsx(`p`,{children:`An origin server hosts a 400×300 image; the goal is to cut out a 200×100 section with the dog’s muzzle.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=eebd18fc78734570a4adfca3d954aa09`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`363`,height:`363`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=d39ec70a4536e25b0b6f1c750abd086c 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=e3875b5cba98db93c68663b7bbf0a394 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=f106f3cc7d31ce651658b58f38da5e1b 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=c41056afe4bdc118b55b460cd7ee2514 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=17ef3246bdc952c7b82d214700628543 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474628113.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=df1d15a48ec0a39bf93c4bdd040efe3b 2500w`})}),_jsx(`p`,{children:`To crop an image, add the query parameter to the URL:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`img.jpg?crop=200,100,x107,y30`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(`p`,{children:`Before being delivered to an end user, the image goes through these conversions:`}),_jsxs(`p`,{children:[`1. The target area is 200×100 (`,_jsx(_components.code,{children:`crop=200,100`}),`), so the tool selects this area in the picture.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=19c56f6ed9a6415e41780bcaff72e330`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`363`,height:`363`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=9d675589b0502519c943971e0a6d1849 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=bbd07a1462977f8cfe9937a474440b38 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=5f46d6eb58d451370e26cc6b274a6afa 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=825d5eb967ca7b444953d9261f1f726a 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=88d772bea7f3d0ecb5beb1e3e6de5513 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474783121.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=e9d81d6bb3a0f1d0f96e751aab9d8502 2500w`})}),_jsxs(`p`,{children:[`2. The coordinates of the starting point are 107 px from the left side and 30 pixels from the top (`,_jsx(_components.code,{children:`x107,y30`}),`). The tool drags the target area so that its upper-left corner is at this point.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=cd22fa5df8a374b7a82b6c00a4bcddaf`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`363`,height:`363`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=2245930142c1b3ac50a800740830fd7d 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=3fd19b4670c6982b501a7072d1b5cb1c 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=5308266754b789b8f0107d7126c0e91d 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=4602fda87c6b78e1971d7f2bd6ecf17a 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=0a122fdfa55207b6d6603f748c498aed 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474833169.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=0213afb4e2ed07a9e1f7d3e7aac82233 2500w`})}),_jsx(`p`,{children:`3. The tool cuts out the section. The cropped image looks as follows:`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b70feac319c8bb7920a3cfc6c79c25d6`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`200`,width:`200`,\"data-og-height\":`99`,height:`99`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b266879f59465a5b6ff7da5c6a5bc4fd 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=79cd3b0d8e99d0514f3b4b46cbe39191 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a4326bc2190bd3ec7996d712e861379b 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=759d2e0185f7be1aae769de36eca160a 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a34f0569ebecb0704720e2ed9564d9b7 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=4d6ebf7eae0c68afd9f4271512346577 2500w`})}),_jsx(Heading,{level:`4`,id:`specify-a-location-using-two-coordinates-measured-as-a-percentage-of-the-original-image`,children:`Specify a location using two coordinates measured as a percentage of the original image`}),_jsxs(`p`,{children:[_jsx(_components.strong,{children:`Parameter:`}),` `,_jsx(_components.code,{children:`?crop=300,200,x25p,y10p`})]}),_jsx(`p`,{children:`where:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`300`}),` = the target width`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`200`}),` = the target height`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`25`}),` = the percent of the original width to offset from the left side`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`10`}),` = the percent of the original height to offset from the top`]}),`\n`]}),_jsx(`p`,{children:`The tool positions the target area so that its upper-left corner is at the specified coordinate, then cuts out the section.`}),_jsx(`p`,{children:`An origin server hosts a 400×300 image; the goal is to cut out a 200×100 section with the dog’s muzzle.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=95449d848bfab7c0a7ffb0612ec0d80a`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`360`,height:`360`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=c8a3e065fd17051971fa2f316febfcaf 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=3ef29d1d70da0b668ff1e677cca0eaba 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b31b781bc1aed4926ad9327877d7aab4 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=8a0809e1f2acb53a1cfea8f06a3a333e 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=aaf626bccc5d666e2c8ffceadf6fb085 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483676177.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=45c1fcf51e402986b1698f5a31b3e0c6 2500w`})}),_jsx(`p`,{children:`To crop an image, add the query parameter to the URL:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`img.jpg?crop=200,100,x25p,y10p`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(`p`,{children:`Before being delivered to an end user, the image goes through these conversions:`}),_jsxs(`p`,{children:[`1. The target area is 200×100 (`,_jsx(_components.code,{children:`crop=200,100`}),`), so the tool selects this area in the picture.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=ada1adea50c44bb960dd3d80f3f25451`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`362`,height:`362`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=7b20755d02a180641301e9a699295ea2 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=26ba4edb70146161540d6e59b8b38b85 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a240b07fa66c416031c3215e0531e8bb 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=c37dd55d4f705c62ee03333290810ae5 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=9940e37fa938cfbe32763cf7953d6fbf 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475042705.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=ea28fa1fc22e28d4f5cff1528f53678b 2500w`})}),_jsxs(`p`,{children:[`2. The starting point for cropping (`,_jsx(_components.code,{children:`x25p,y10p`}),`): offset 25% of the original width from the left side and 10% of the original height from the top. The tool drags the target area so that its upper-left corner is at this point.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png?fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=a9c2945417265581d3f3cffe695cbd19`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`730`,width:`730`,\"data-og-height\":`441`,height:`441`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png?w=280\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=0465150512537b6c7a5ab004ffe3867d 280w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png?w=560\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=fd25e4d59fe890b6f467685122fd9755 560w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png?w=840\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=673182b080244a4288fabe66c25e1b93 840w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png?w=1100\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=e68305395311a7432ae407f7292c05ac 1100w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png?w=1650\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=ef19ae778b6f0717a797b4abe4dfc16f 1650w, https://mintcdn.com/gcore/-KfIdBsV7ok6Y4Qg/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475091729.png?w=2500\u0026fit=max\u0026auto=format\u0026n=-KfIdBsV7ok6Y4Qg\u0026q=85\u0026s=540440d1de37d15a1fd9001e77df618f 2500w`})}),_jsx(`p`,{children:`3. Then it cuts out the section. The cropped image looks as follows:`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b70feac319c8bb7920a3cfc6c79c25d6`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`200`,width:`200`,\"data-og-height\":`99`,height:`99`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b266879f59465a5b6ff7da5c6a5bc4fd 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=79cd3b0d8e99d0514f3b4b46cbe39191 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a4326bc2190bd3ec7996d712e861379b 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=759d2e0185f7be1aae769de36eca160a 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a34f0569ebecb0704720e2ed9564d9b7 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029474904721.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=4d6ebf7eae0c68afd9f4271512346577 2500w`})}),_jsx(Heading,{level:`4`,id:`specify-a-location-using-the-ratio-of-unwanted-areas`,children:`Specify a location using the ratio of unwanted areas`}),_jsxs(`p`,{children:[_jsx(_components.strong,{children:`Parameter:`}),` `,_jsx(_components.code,{children:`?crop=300,200,offset-x20,offset-y40`})]}),_jsx(`p`,{children:`where:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`300`}),` = the target width`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`200`}),` = the target height`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`20`}),` = the percent of the unwanted width that should be cropped from the left side`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`40`}),` = the percent of the unwanted height that should be cropped from the top`]}),`\n`]}),_jsx(`p`,{children:`The tool positions the target area so that the specified percentage of unwanted area remains on the left and on the top, then crops the image.`}),_jsx(`p`,{children:`An origin server hosts a 400×300 image; the goal is to cut out a 100×100 section with the dog’s paws.`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=de3e74fcc0bfb205e234009abb0cb03d`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`362`,height:`362`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=0201ea3d1f09191d36e124f0244aa999 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=782c4b7b85d0fafc59c31d463f5ccb55 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=28b846ecd1d18a69d3d55e565261574f 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=436c4526c7288171847877b424379d2c 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=80bad87c05e91495a0f80dffa6cd6760 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029483884945.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=0c9bd43e9fcc6f6ae8ab61bba5ae76f2 2500w`})}),_jsx(`p`,{children:`To crop the image, add the query parameter to the URL:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`img.jpg?crop=100,100,offset-x50,offset-y81`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(`p`,{children:`Before being delivered to an end user, the image goes through these conversions:`}),_jsxs(`p`,{children:[`1. The target area is 100×100 (`,_jsx(_components.code,{children:`crop=100,100`}),`). The tool selects the target area in the picture.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=e22c2caf082b56a5f194e766ed130799`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`362`,height:`362`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=8bcc34871d3974d373e53de8be528b60 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=99679a434013daec317c3392d5886ca1 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=e9e45e35880a61b6fb0cd811b01ff31e 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=13012b22afa0cfd7bc27e3665cc4e2d2 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=70c68b103ed8d158f921cab3c21fd988 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475244561.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=f735f88361b65582c5ad0eb23289f9fd 2500w`})}),_jsxs(`p`,{children:[`2. The tool drags the target area to the right until 50% of the unwanted width remains on the left (`,_jsx(_components.code,{children:`offset-x50`}),`). Accordingly, 50% of the unwanted area remains on the right.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=3f6b6a53188dd7cf2985912839cb3056`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`520`,width:`520`,\"data-og-height\":`362`,height:`362`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=e9ee4c5c212d6e7c702ca96409cc2ec5 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b4c86662cb39dbcfc76f8586a988484e 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=05f9580c66fa7c44b27b02f7a08f04bd 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=72457b94dee0a7eb064ef5450ee7f61a 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a602a02d61863e3e8422478caff9f765 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029484044049.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=c17b1fd3ec40e1a214b7c0652c5913cd 2500w`})}),_jsxs(`p`,{children:[`3. It moves the target area down until 81% of the unwanted height remains on the top (`,_jsx(_components.code,{children:`offset-y81`}),`). Accordingly, 19% of the unwanted height remains at the bottom.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a44c2060c028e92523d6b086c09eedfc`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`576`,width:`576`,\"data-og-height\":`363`,height:`363`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=948bd4c281af24ee19c8b6fd9447a3f3 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a802a0d89a62857601e67e2c422c1939 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b237670a5ebcfd2d4e053815b9b9ee08 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=5020d9a44916a6ab044d21ddbdd5a760 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=d3818b227ef33200a782faff3314f0c6 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475395345.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=3e0bb0b49efd0aca67831bf07c27cd7c 2500w`})}),_jsx(`p`,{children:`4. The tool cuts out the target area. The cropped image looks as follows:`}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=92b5b49810222352810b46ce1b6f7a71`,alt:`Crop a section of an original image from a specific location`,\"data-og-width\":`100`,width:`100`,\"data-og-height\":`99`,height:`99`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=a731599dea134832a08cd36fd436f6da 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=29110a4237fdac48a287042105a8a54a 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=4a77da275324d83067a1a4ddf3664394 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=dff00eebb64be6872305c75ab9201a59 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=f7e3c6bf237b11b08bc040664096d455 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475474321.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=6fb0bf9dc941253cb1dc8a1a6d1c2ce5 2500w`})}),_jsx(Heading,{level:`4`,id:`combine-location-parameters`,children:`Combine location parameters`}),_jsx(`p`,{children:`Pixel coordinates, a percentage of the original image, and an offset based on the unwanted area can be combined.`}),_jsx(`p`,{children:`Combined query parameters:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`?crop=width,height,x(x-axis value),offset-y(percentage of unwanted area to be cropped from the top)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`?crop=width,height,offset-x(percentage of unwanted area to be cropped from the left),y(y-axis value)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`?crop=width,height,x(percentage of original image width from the left)p,offset-y(percentage of unwanted area to be cropped from the top)`})}),`\n`]}),_jsx(`p`,{children:`The cropping behavior for combined parameters follows the same rules as the individual options above.`}),_jsx(Heading,{level:`2`,id:`check-http-headers`,children:`Check HTTP headers`}),_jsxs(`p`,{children:[`Check the HTTP response headers to verify that the crop was applied. The `,_jsx(_components.code,{children:`X-Img-Operations`}),` header lists all conversions performed. If the value includes `,_jsx(_components.code,{children:`crop`}),`, the image has been cropped.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=f5e2d3f4030a6a3c5e8c7673e0b8b85f`,alt:`Check HTTP headers`,\"data-og-width\":`440`,width:`440`,\"data-og-height\":`381`,height:`381`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=7eb50a1ed94e2c157749e31e72750ad3 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=7df8f0aa7d9165a350c5ea0e0a958f3c 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=b8b0d5bf43152336531ea4c462c9bd6c 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=92359b1e00e326261ae70a3394aaf103 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=857ea25f9826db316471b93e69d571f1 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475507985.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=8378fd5fadb296c122eebfb73e4c28ba 2500w`})}),_jsxs(`p`,{children:[`If `,_jsx(_components.code,{children:`X-Img-Operations`}),` does not include `,_jsx(_components.code,{children:`crop`}),` and the CDN returns the original uncropped image, check the `,_jsx(_components.code,{children:`img-skip-reason`}),` header. This explains why the conversion failed.`]}),_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png?fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=d26a9ec609bf1d22d092c440c4476d6d`,alt:`Check HTTP headers`,\"data-og-width\":`397`,width:`397`,\"data-og-height\":`298`,height:`298`,\"data-path\":`images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png?w=280\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=9c028b9cea1c9c187ea09ce4bcb94a25 280w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png?w=560\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=d90c090cbe830aa56bd0580d91eb1881 560w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png?w=840\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=6561403a5f81e186d1aa14a8a71a61a9 840w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=7e33f83523c51ed6bf5eb7007c28dce3 1100w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=71a9b8c89e6063881edfd0ed89ad3d09 1650w, https://mintcdn.com/gcore/jGvvbKmzzlO7ynHV/images/docs/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images/11029475548049.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jGvvbKmzzlO7ynHV\u0026q=85\u0026s=d25788fd0630c5df19c7861767f23306 2500w`})})]})}),_jsx(_MdxComponentBoundary,{name:`MethodSection`,children:_jsxs(MethodSection,{id:`api`,label:`REST API`,children:[_jsxs(`p`,{children:[`Crop trims the picture a viewer receives down to one area of the original. The area is a `,_jsx(_components.code,{children:`crop`}),` query parameter on the image URL, and Image Stack has to be on before that parameter is applied.`]}),_jsx(Info,{children:_jsxs(_components.p,{children:[`An `,_jsx(_components.a,{href:`/account-settings/api-tokens`,children:`API\\xA0token`}),` is required. The CDN resource ID is the `,_jsx(_components.code,{children:`id`}),` from the `,_jsx(_components.a,{href:`/api-reference/cdn/cdn-resources/list-cdn-resources`,children:`resources\\xA0list`}),` call.`]})}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` GCORE_API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{YOUR_API_KEY}\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` CDN_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{YOUR_CDN_RESOURCE_ID}\"`})]}),`\n`]})})}),_jsx(Heading,{level:`2`,id:`turn-image-stack-on`,children:`Turn Image Stack on`}),_jsxs(`p`,{children:[`Gcore CDN reads `,_jsx(_components.code,{children:`crop`}),` from the image URL only when Image Stack is enabled. A `,_jsx(_components.code,{children:`crop`}),` key inside `,_jsx(_components.code,{children:`image_stack`}),` is not stored.`]}),_jsxs(`p`,{children:[_jsx(_components.code,{children:`enabled`}),` is required. This call sets `,_jsx(_components.code,{children:`quality`}),` to 80 and turns WebP on. Send every field that should stay set, because a field left out of the request is stored as its default.`]}),_jsxs(Tabs,{children:[_jsx(Tab,{title:`Python SDK`,id:`python-sdk`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`21`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`21`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` gcore `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Gcore`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Gcore()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`resource_id `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CDN_RESOURCE_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`])`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`updated `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.cdn.cdn_resources.update(`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` resource_id,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` options`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"image_stack\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`True`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quality\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`80`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"webp_enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`True`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"avif_enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`False`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"png_lossless\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`False`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`saved `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` updated.options.image_stack`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(saved.enabled, saved.quality, saved.webp_enabled, saved.avif_enabled, saved.png_lossless)`})]}),`\n`]})})})}),_jsx(Tab,{title:`Go SDK`,id:`go-sdk`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`37`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`37`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`package`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` main`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#CE9178`},children:`context`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#CE9178`},children:`fmt`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#CE9178`},children:`os`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#CE9178`},children:`strconv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` gcore`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#CE9178`},children:`github.com/G-Core/gcore-go`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#CE9178`},children:`github.com/G-Core/gcore-go/cdn`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`func`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` main`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` :=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` gcore`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`NewClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ctx`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` :=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` context`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Background`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resourceID`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`err`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` :=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` strconv`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`ParseInt`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`os`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Getenv`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CDN_RESOURCE_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`), `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`64`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` err`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` !=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` nil`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` panic`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`err`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` updated`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`err`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` :=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`CDN`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`CDNResources`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Update`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ctx`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`resourceID`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`cdn`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`CDNResourceUpdateParams`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Options`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`cdn`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`CDNResourceUpdateParamsOptions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ImageStack`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`cdn`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`CDNResourceUpdateParamsOptionsImageStack`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Enabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Quality`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`gcore`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`80`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` WebpEnabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`gcore`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Bool`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` AvifEnabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`gcore`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Bool`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` PngLossless`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`gcore`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Bool`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` err`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` !=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` nil`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` panic`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`err`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` saved`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` :=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` updated`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Options`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ImageStack`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` fmt`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`Println`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`saved`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Enabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`saved`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Quality`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`saved`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`WebpEnabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`saved`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`AvifEnabled`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`saved`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`PngLossless`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),_jsxs(Tab,{title:`curl`,id:`curl`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.gcore.com/cdn/resources/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$CDN_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: APIKey `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$GCORE_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"options\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"image_stack\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"enabled\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quality\": 80,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"webp_enabled\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"avif_enabled\": false,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"png_lossless\": false`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(`p`,{children:`The API returns HTTP 200. The saved option is:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"avif_enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"webp_enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"quality\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`80`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"png_lossless\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]}),_jsx(Heading,{level:`2`,id:`crop-the-image-url`,children:`Crop the image URL`}),_jsxs(`p`,{children:[_jsx(_components.code,{children:`crop`}),` is not an API field. Add it to the image URL:`]}),_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=16:9`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200,x100,y50`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200,x25p,y10p`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200,offset-x20,offset-y40`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(`p`,{children:[_jsx(_components.code,{children:`16:9`}),` keeps that aspect ratio at the center. `,_jsx(_components.code,{children:`300,200`}),` is the width and height, also from the center. `,_jsx(_components.code,{children:`x100,y50`}),` and `,_jsx(_components.code,{children:`x25p,y10p`}),` place the top-left corner in pixels or as a percent of the original. `,_jsx(_components.code,{children:`offset-x20,offset-y40`}),` leaves that percent of the trimmed-away area on the left and on the top.`]})]})}),_jsx(_MdxComponentBoundary,{name:`MethodSection`,children:_jsxs(MethodSection,{id:`terraform`,label:`Terraform`,children:[_jsxs(`p`,{children:[`Crop trims the picture a viewer receives down to one area of the original. The area is a `,_jsx(_components.code,{children:`crop`}),` query parameter on the image URL, and Image Stack has to be on before that parameter is applied. Declare Image Stack with the `,_jsx(_components.a,{href:`/developer-tools/terraform/overview`,children:`Terraform\\xA0provider`}),` v2.`]}),_jsxs(`p`,{children:[_jsx(_components.code,{children:`image_stack`}),` has no `,_jsx(_components.code,{children:`crop`}),` argument. A `,_jsx(_components.code,{children:`crop`}),` key in that object is left out of the saved option. Add `,_jsx(_components.code,{children:`crop`}),` to the image URL.`]}),_jsx(Heading,{level:`2`,id:`turn-image-stack-on-2`,children:`Turn Image Stack on`}),_jsxs(`p`,{children:[`Gcore CDN reads `,_jsx(_components.code,{children:`crop`}),` from the image URL only when Image Stack is enabled. Set `,_jsx(_components.code,{children:`enabled`}),`, `,_jsx(_components.code,{children:`quality`}),`, `,_jsx(_components.code,{children:`webp_enabled`}),`, `,_jsx(_components.code,{children:`avif_enabled`}),`, and `,_jsx(_components.code,{children:`png_lossless`}),`. A field left out of the object is stored as its default, so keep every field that should stay set, then run `,_jsx(_components.code,{children:`terraform apply`}),`.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`26`,language:`hcl`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`hcl`,children:_jsxs(_components.code,{language:`hcl`,numberOfLines:`26`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`resource`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` \"gcore_cdn_origin_group\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` \"example\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"my-origin-group\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sources`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` source`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"example.com\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` enabled`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`resource`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` \"gcore_cdn_resource\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` \"example\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` cname`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"cdn.example.com\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` origin_group`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` gcore_cdn_origin_group`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`example`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` origin_protocol`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"HTTPS\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` options`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` image_stack`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` enabled`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` true`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` quality`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 80`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` webp_enabled`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` true`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` avif_enabled`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` false`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` png_lossless`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(Heading,{level:`2`,id:`crop-the-image-url-2`,children:`Crop the image URL`}),_jsxs(`p`,{children:[_jsx(_components.code,{children:`crop`}),` is not a Terraform field. Add it to the image URL:`]}),_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=16:9`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200,x100,y50`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200,x25p,y10p`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`image.jpg?crop=300,200,offset-x20,offset-y40`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(`p`,{children:[_jsx(_components.code,{children:`16:9`}),` keeps that aspect ratio at the center. `,_jsx(_components.code,{children:`300,200`}),` is the width and height, also from the center. `,_jsx(_components.code,{children:`x100,y50`}),` and `,_jsx(_components.code,{children:`x25p,y10p`}),` place the top-left corner in pixels or as a percent of the original. `,_jsx(_components.code,{children:`offset-x20,offset-y40`}),` leaves that percent of the trimmed-away area on the left and on the top.`]})]})})]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{MethodSection,MethodSwitch,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Crop images","sidebarTitle":"Crop","description":"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.","href":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[130,2195,")=>null;const MethodSwitch=()=>null;func"]]},"mdxExtracts":{"tableOfContents":[{"title":"Enable the crop feature","slug":"enable-the-crop-feature","depth":2,"children":[]},{"title":"Use crop","slug":"use-crop","depth":2,"children":[]},{"title":"Crop parameters","slug":"crop-parameters","depth":2,"children":[{"title":"Crop an image by customizing its aspect ratio","slug":"crop-an-image-by-customizing-its-aspect-ratio","depth":3,"children":[]},{"title":"Crop an image at its center","slug":"crop-an-image-at-its-center","depth":3,"children":[]},{"title":"Crop from a specific location","slug":"crop-from-a-specific-location","depth":3,"children":[]},{"title":"Specify a location with two offsets measured in pixels","slug":"specify-a-location-with-two-offsets-measured-in-pixels","depth":4,"children":[]},{"title":"Specify a location using two coordinates measured as a percentage of the original image","slug":"specify-a-location-using-two-coordinates-measured-as-a-percentage-of-the-original-image","depth":4,"children":[]},{"title":"Specify a location using the ratio of unwanted areas","slug":"specify-a-location-using-the-ratio-of-unwanted-areas","depth":4,"children":[]},{"title":"Combine location parameters","slug":"combine-location-parameters","depth":4,"children":[]}]},{"title":"Check HTTP headers","slug":"check-http-headers","depth":2,"children":[]},{"title":"Turn Image Stack on","slug":"turn-image-stack-on","depth":2,"children":[]},{"title":"Crop the image URL","slug":"crop-the-image-url","depth":2,"children":[]},{"title":"Turn Image Stack on","slug":"turn-image-stack-on-2","depth":2,"children":[]},{"title":"Crop the image URL","slug":"crop-the-image-url-2","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/gcore/2036a8623c2fd228/click-tracking.js","/_mintlify/custom/gcore/7e445330ba6f8624/sidebar-scroll.js","/_mintlify/custom/gcore/ee548232b11d6903/matomo-tag-manager.js","/_mintlify/custom/gcore/a5667dd33811c051/api-key-prefix.js","/_mintlify/custom/gcore/bc738e6ecd848aff/fastedge-agent-setup.js","/_mintlify/custom/gcore/f63d6d6c2b4ef65b/discord-banner.js","/_mintlify/custom/gcore/763d6fd05607cf57/show-footer.js"],"dynamicCss":".mint--mb-px {\n margin-bottom: -1px\n}\n.mint-mb-8 {\n margin-bottom: 2rem\n}\n.mint-mt-2 {\n margin-top: 0.5rem\n}\n.mint-flex {\n display: flex\n}\n.mint-cursor-pointer {\n cursor: pointer\n}\n.mint-gap-0 {\n gap: 0px\n}\n.mint-border-b {\n border-bottom-width: 1px\n}\n.mint-border-b-2 {\n border-bottom-width: 2px\n}\n.mint-border-transparent {\n border-color: transparent\n}\n.mint-border-zinc-200 {\n --tw-border-opacity: 1;\n border-color: rgb(228 228 231 / var(--tw-border-opacity, 1))\n}\n.mint-px-4 {\n padding-left: 1rem;\n padding-right: 1rem\n}\n.mint-py-2 {\n padding-top: 0.5rem;\n padding-bottom: 0.5rem\n}\n.mint-text-sm {\n font-size: 0.875rem;\n line-height: 1.25rem\n}\n.mint-font-medium {\n font-weight: 500\n}\n.mint-text-zinc-500 {\n --tw-text-opacity: 1;\n color: rgb(113 113 122 / var(--tw-text-opacity, 1))\n}\n.mint-transition-colors {\n transition-property: color, background-color, border-color, text-decoration-color, fill, stroke;\n transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);\n transition-duration: 150ms\n}\n.hover\\:mint-text-zinc-800:hover {\n --tw-text-opacity: 1;\n color: rgb(39 39 42 / var(--tw-text-opacity, 1))\n}\n.dark\\:mint-border-zinc-800:is(.dark *) {\n --tw-border-opacity: 1;\n border-color: rgb(39 39 42 / var(--tw-border-opacity, 1))\n}\n.dark\\:hover\\:mint-text-zinc-200:hover:is(.dark *) {\n --tw-text-opacity: 1;\n color: rgb(228 228 231 / var(--tw-text-opacity, 1))\n}","subdomain":"gcore","siteName":"Gcore Documentation","title":"Crop images - Gcore Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T10:19:35.886Z","originalFileLocation":"cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gcore Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Crop images - Gcore Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gcore Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gcore.mintlify.site/_mintlify/api/og/v2?division=Image+stack+tools\u0026amp;title=Crop+images\u0026amp;description=Crop+trims+JPG+or+PNG+images+before+CDN+delivery+using+query+parameters+to+set+aspect+ratio+and+crop+location.\u0026amp;theme=b86fe3c8b8ff0d8b51d4e9d0\u0026amp;signature=f18ceec312ac54c2345be03a874ba2667e30db21663dfcdb5b094fe71e2f2c4d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Crop images - Gcore Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gcore.mintlify.site/_mintlify/api/og/v2?division=Image+stack+tools\u0026amp;title=Crop+images\u0026amp;description=Crop+trims+JPG+or+PNG+images+before+CDN+delivery+using+query+parameters+to+set+aspect+ratio+and+crop+location.\u0026amp;theme=b86fe3c8b8ff0d8b51d4e9d0\u0026amp;signature=f18ceec312ac54c2345be03a874ba2667e30db21663dfcdb5b094fe71e2f2c4d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gcore/HLHUAJeezGzYCOI_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gcore Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff4c00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gcore.com/#organization\",\"name\":\"Gcore Documentation\",\"url\":\"https://docs.gcore.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gcore/6eTmdOhRD-GYL1w_/logo/logo.svg?fit=max\u0026auto=format\u0026n=6eTmdOhRD-GYL1w_\u0026q=85\u0026s=d2792deb0bdf1974d7b21cdfc4b77d6a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gcore.com#website\",\"name\":\"Gcore Documentation\",\"url\":\"https://docs.gcore.com\",\"publisher\":{\"@id\":\"https://docs.gcore.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images#webpage\",\"url\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images\",\"name\":\"Crop images\",\"description\":\"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.\",\"dateModified\":\"2026-10-27T10:19:35.886Z\",\"isPartOf\":{\"@id\":\"https://docs.gcore.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CDN\",\"item\":\"https://docs.gcore.com/cdn\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CDN resource options\",\"item\":\"https://docs.gcore.com/cdn/cdn-resource-options/general/specify-an-origin-and-the-origin-pull-protocol\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Image optimization (paid)\",\"item\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/about-image-stack\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Image stack tools\",\"item\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/configure-image-compression-to-webp-and-avif\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Crop images\",\"item\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images#article\",\"headline\":\"Crop images\",\"name\":\"Crop images\",\"description\":\"Crop trims JPG or PNG images before CDN delivery using query parameters to set aspect ratio and crop location.\",\"url\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gcore.com/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images#webpage\"},\"dateModified\":\"2026-10-27T10:19:35.886Z\",\"publisher\":{\"@id\":\"https://docs.gcore.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gcore.com#website\"}}]}\u003c/script>","agentPointerHref":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images.md","siteName":"Gcore Documentation","nav":{"global":{"anchors":[{"anchor":"Home","icon":"user","href":"https://docs.gcore.com/"},{"anchor":"Gcore Status","icon":"waveform","href":"https://status.gcore.com/"}]},"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/home"}]},{"tab":"Documentation","groups":[{"group":"Account settings","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/account-settings"},{"group":"My profile","expanded":false,"pages":[{"title":"My profile settings","sidebarTitle":"Overview","href":"/account-settings/my-profile/overview"},{"title":"Set up two-factor authentication","sidebarTitle":"Two-factor authentication","href":"/account-settings/my-profile/two-factor-authentication"},{"title":"Change or reset a password","sidebarTitle":"Change or reset","href":"/account-settings/my-profile/change-password"},{"title":"Missing password reset email","sidebarTitle":"No reset email","href":"/account-settings/my-profile/password-reset-email"}]},{"group":"Account","expanded":false,"pages":[{"title":"Account overview","sidebarTitle":"Overview","href":"/account-settings/account/overview"},{"title":"Create an account for an individual or legal entity","sidebarTitle":"Account","href":"/account-settings/account/create-account"},{"title":"Create an additional account and switch between accounts","sidebarTitle":"Additional accounts","href":"/account-settings/account/additional-accounts"},{"title":"Disable or resume services","sidebarTitle":"Services","href":"/account-settings/account/services"},{"title":"Account deletion","sidebarTitle":"Account deletion","href":"/account-settings/account/account-deletion"}]},{"group":"Billing","expanded":false,"pages":[{"title":"Billing overview","sidebarTitle":"Overview","href":"/account-settings/billing/overview"},{"title":"Expenses","sidebarTitle":"Expenses","href":"/account-settings/billing/expenses"},{"title":"Payments and payment methods","href":"/account-settings/billing/payments"},{"title":"Bonuses and discounts","href":"/account-settings/billing/bonuses-and-discounts"},{"title":"Trial conditions","href":"/account-settings/billing/trial-conditions"},{"title":"VAT rates in different countries for an individual and legal entity","href":"/account-settings/billing/vat-rates"},{"title":"Tax location","href":"/account-settings/billing/tax-location"},{"title":"Data deletion","href":"/account-settings/billing/data-deletion"}]},{"group":"Users","expanded":false,"pages":[{"title":"About users","href":"/account-settings/users/about-users"},{"title":"Manage users","sidebarTitle":"Manage","href":"/account-settings/users/manage-users"}]},{"title":"API tokens","sidebarTitle":"API tokens","href":"/account-settings/api-tokens"},{"title":"Manage notification settings","sidebarTitle":"Notifications","href":"/account-settings/notifications"},{"group":"Support and resources","expanded":false,"pages":[{"title":"Technical support","sidebarTitle":"Technical support","href":"/account-settings/how-quickly-our-support-team-will-respond-to-you"},{"title":"Monitor service status and maintenance","sidebarTitle":"Status page","href":"/account-settings/be-aware-of-the-service-status-scheduled-and-emergency-maintenance"},{"title":"Roadmap: submit feedback and track feature development","sidebarTitle":"Roadmap","href":"/account-settings/roadmap-provide-feedback-suggest-new-features-follow-development"}]}]},{"group":"CDN","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/cdn"},{"title":"CDN packages","sidebarTitle":"CDN packages","href":"/cdn/cdn-packages"},{"title":"How Gcore CDN works","sidebarTitle":"How CDN works","href":"/cdn/how-cdn-works"},{"group":"Getting Started","expanded":false,"pages":[{"group":"Create a CDN resource","expanded":false,"pages":[{"title":"CDN resource overview","href":"/cdn/getting-started/create-a-cdn-resource/overview"},{"title":"Create a CDN resource","sidebarTitle":"Create a resource","href":"/cdn/getting-started/create-a-cdn-resource/create-a-cdn-resource"},{"title":"Create a CDN resource for video streaming","sidebarTitle":"For video streaming","href":"/cdn/getting-started/create-a-cdn-resource/create-a-cdn-resource-for-video-streaming"}]},{"group":"Integrate CDN with CMS and other platforms","expanded":false,"pages":[{"title":"CMS and platform integrations","sidebarTitle":"CMS and platform integrations","href":"/cdn/getting-started/integrate-cdn-with-cms"},{"title":"Use an AWS S3 static website as a CDN origin","sidebarTitle":"AWS S3 static website","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-aws-s3"},{"title":"Integrate a CDN resource with b2evolution","sidebarTitle":"b2evolution","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-b2evolution"},{"title":"Integrate a CDN resource with Cloudflare","sidebarTitle":"Cloudflare","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-cloudflare"},{"title":"Integrate a CDN resource with Concrete CMS","sidebarTitle":"Concrete CMS","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-concrete5"},{"title":"Integrate a CDN resource with Craft CMS","sidebarTitle":"Craft","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-craft"},{"title":"Integrate a CDN resource with CS-Cart","sidebarTitle":"CS-Cart","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-cs-cart"},{"title":"Integrate a CDN resource with Django CMS","sidebarTitle":"Django CMS","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-django-cms"},{"title":"Integrate a CDN resource with Drupal","sidebarTitle":"Drupal","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-drupal"},{"title":"Integrate a CDN resource with Google Cloud Storage","sidebarTitle":"Google Cloud Storage","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-google-cloud-storage"},{"title":"Integrate a CDN resource with IPB","sidebarTitle":"IPB","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-ipb"},{"title":"Integrate a CDN resource with Invision Community Classic 4.x","sidebarTitle":"Invision Community","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-ips"},{"title":"Integrate a CDN resource with Joomla","sidebarTitle":"Joomla","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-joomla"},{"title":"Integrate a CDN resource with Kirby","sidebarTitle":"Kirby","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-kirby"},{"title":"Integrate a CDN resource with Magento","sidebarTitle":"Magento","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-magento"},{"title":"Integrate a CDN resource with Perch","sidebarTitle":"Perch","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-perch"},{"title":"Integrate a CDN resource with PrestaShop","sidebarTitle":"PrestaShop","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-prestashop"},{"title":"Integrate a CDN resource with PyroCMS 2.x","sidebarTitle":"PyroCMS","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-pyrocms"},{"title":"Integrate a CDN resource with SocialEngine","sidebarTitle":"SocialEngine","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-socialengine"},{"title":"Integrate a CDN resource with TYPO3","sidebarTitle":"TYPO3","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-typo3"},{"title":"Integrate a CDN resource with vBulletin","sidebarTitle":"vBulletin","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-vbulletin"},{"title":"Integrate a CDN resource with Webasyst","sidebarTitle":"Webasyst","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-webasyst"},{"group":"Wordpress","expanded":false,"pages":[{"title":"Integrate a CDN resource with WordPress using the Gcore plugin","sidebarTitle":"Gcore plugin","href":"/cdn/getting-started/integrate-cdn-with-cms/wordpress/integrate-cdn-resource-with-wordpress-gcore-plugin"},{"title":"Integrate a CDN resource with WordPress using WP Rocket","sidebarTitle":"WP Rocket","href":"/cdn/getting-started/integrate-cdn-with-cms/wordpress/integrate-cdn-resource-with-wordpress-rocket-plugin"},{"title":"Integrate a CDN resource with WordPress using W3 Total Cache","sidebarTitle":"W3 Total Cache plugin","href":"/cdn/getting-started/integrate-cdn-with-cms/wordpress/integrate-cdn-resource-with-wordpress-w3-total-cache-plugin"},{"title":"Integrate a CDN resource with WordPress using WP Super Cache","sidebarTitle":"WP Super Cache plugin","href":"/cdn/getting-started/integrate-cdn-with-cms/wordpress/integrate-cdn-resource-with-wordpress-wp-supercache-plugin"}]},{"title":"Integrate a CDN resource with X-Cart 4.4.x","sidebarTitle":"X-Cart","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-x-cart"},{"title":"Integrate CDN resource with XenForo","sidebarTitle":"XenForo","href":"/cdn/getting-started/integrate-cdn-with-cms/integrate-cdn-resource-with-xenforo"}]},{"title":"Extend CDN functionality with FastEdge","sidebarTitle":"CDN applications","href":"/cdn/getting-started/integrate-cdn-with-fastedge"},{"group":"Configure an origin","expanded":false,"pages":[{"title":"Allow Gcore CDN access to an origin","sidebarTitle":"Allow CDN origin access","href":"/cdn/getting-started/configure-an-origin/add-cdn-servers-to-the-origin-acl-whitelist"},{"title":"Configure HTTP/2 on the origin","sidebarTitle":"HTTP/2","href":"/cdn/getting-started/configure-an-origin/configure-http-2-on-the-origin"}]},{"title":"CDN timeouts","sidebarTitle":"Timeouts","href":"/cdn/getting-started/cdn-timeouts"}]},{"title":"About CDN resources interface: how it is arranged","sidebarTitle":"CDN resources overview","href":"/cdn/about-cdn-resources-interface-how-it-is-arranged"},{"title":"Origin groups for CDN resources","sidebarTitle":"Origin group","href":"/cdn/add-an-origin-group"},{"group":"CDN resource options","expanded":false,"pages":[{"group":"General","expanded":false,"pages":[{"title":"Specify an origin and the origin pull protocol","sidebarTitle":"Specify an origin","href":"/cdn/cdn-resource-options/general/specify-an-origin-and-the-origin-pull-protocol"},{"title":"Use a private bucket as an origin","sidebarTitle":"Private origin","href":"/cdn/cdn-resource-options/general/use-a-private-bucket-as-an-origin"},{"title":"Enable origin SSL validation","sidebarTitle":"Enable SSL validation","href":"/cdn/cdn-resource-options/general/enable-origin-ssl-validation"},{"title":"Set a custom domain for CDN","sidebarTitle":"Create a custom domain (CNAME)","href":"/cdn/cdn-resource-options/general/create-and-set-a-custom-domain-for-the-content-delivery-via-cdn"},{"title":"Enable and configure origin shielding","sidebarTitle":"Enable shielding (paid)","href":"/cdn/cdn-resource-options/general/enable-and-configure-origin-shielding"},{"title":"Suspend a CDN resource automatically or manually","sidebarTitle":"Suspend a CDN resource","href":"/cdn/cdn-resource-options/general/suspend-a-cdn-resource-automatically-or-manually"},{"title":"Customize connection and read timeouts","sidebarTitle":"Connection and read timeouts","href":"/cdn/cdn-resource-options/general/customize-connection-and-read-timeouts"}]},{"group":"Cache","expanded":false,"pages":[{"title":"CDN cache lifetime configuration","sidebarTitle":"Configure CDN caching","href":"/cdn/cdn-resource-options/cache/specify-cache-lifetime-on-a-cdn-resource-or-origin"},{"title":"Set up a CDN resource to follow origin redirects","sidebarTitle":"Follow redirects from an origin","href":"/cdn/cdn-resource-options/cache/set-up-a-cdn-resource-to-follow-origin-redirects"},{"title":"Specify cache lifetime for user browsers","sidebarTitle":"Configure browser caching","href":"/cdn/cdn-resource-options/cache/specify-cache-lifetime-for-user-browsers"},{"title":"Ignore Set-Cookie or query string parameters when caching content on CDN servers","sidebarTitle":"Ignore Set-Cookie or query strings","href":"/cdn/cdn-resource-options/cache/ignore-the-set-cookie-or-query-string-parameters-when-caching-content-on-cdn-servers"},{"title":"Always online: serve stale cache when the origin cannot provide a fresh response","sidebarTitle":"Serve stale cache from CDN","href":"/cdn/cdn-resource-options/cache/always-online-provide-the-stale-cache-if-the-origin-is-unavailable"},{"title":"Cache Sharding: share cache between CDN servers","sidebarTitle":"Cache Sharding","href":"/cdn/cdn-resource-options/cache/cache-sharding-share-cache-between-cdn-servers"},{"title":"Modify cache key","href":"/cdn/cdn-resource-options/cache/modify-cache-key"},{"title":"Cache images and small static files","sidebarTitle":"Images and static files","href":"/cdn/cdn-resource-options/cache/cache-images-and-small-static-files"}]},{"group":"Access","expanded":false,"pages":[{"title":"Control access to the content with country, referrer, IP, and user agents policies","sidebarTitle":"Manage access policies","href":"/cdn/cdn-resource-options/security/control-access-to-the-content-with-country-referrer-ip-and-user-agents-policies"},{"title":"Set up a redirect from HTTP to HTTPS","sidebarTitle":"Redirect from HTTP to HTTPS","href":"/cdn/cdn-resource-options/security/set-up-a-redirect-from-http-to-https"},{"group":"Secure token","expanded":false,"pages":[{"title":"About secure token","sidebarTitle":"Overview","href":"/cdn/cdn-resource-options/security/use-a-secure-token/about-secure-token"},{"title":"Configure and use secure token","sidebarTitle":"Configure and use","href":"/cdn/cdn-resource-options/security/use-a-secure-token/configure-and-use-secure-token"}]},{"title":"Specify HTTP methods allowed for content requests from the CDN","sidebarTitle":"Specify HTTP methods","href":"/cdn/cdn-resource-options/security/specify-http-methods-allowed-for-content-requests-from-the-cdn"},{"title":"Set the hostname passed in SNI requests to the origin","sidebarTitle":"Set SNI hostname","href":"/cdn/cdn-resource-options/security/set-the-hostname-passed-in-sni-requests-to-the-origin-server"},{"title":"Specify TLS versions allowed for content requests from the CDN","sidebarTitle":"Specify allowed TLS versions","href":"/cdn/cdn-resource-options/security/choose-tls-versions"}]},{"group":"Security","expanded":false,"pages":[{"title":"Protect CDN resources with Gcore WAAP","sidebarTitle":"Gcore WAAP","href":"/cdn/cdn-resource-options/cdn-security/protect-cdn-resources-with-waap"}]},{"group":"Compression","expanded":false,"pages":[{"title":"Configure Gzip and Brotli compression","sidebarTitle":"Gzip, Brotli","href":"/cdn/cdn-resource-options/compression/configure-gzip-and-brotli-compression"},{"title":"Configure fetch compression","sidebarTitle":"Fetch","href":"/cdn/cdn-resource-options/compression/configure-fetch-compression"}]},{"title":"Configuring HTTP status codes for CDN-hosted content","sidebarTitle":"Status code","href":"/cdn/cdn-resource-options/specify-custom-http-status-code-for-the-content-delivered-by-the-cdn"},{"title":"Optimize large file delivery","sidebarTitle":"Large files delivery","href":"/cdn/cdn-resource-options/optimize-large-file-delivery"},{"title":"Redirect requests from the CDN to the origin","sidebarTitle":"Rewrite request paths","href":"/cdn/cdn-resource-options/rewrite-redirect-requests-from-the-cdn-to-the-origin"},{"title":"Redirect a CDN hostname to another domain","sidebarTitle":"Redirect to another domain","href":"/cdn/cdn-resource-options/redirect-one-domain-to-another"},{"title":"Proxy WebSocket connections to the origin","sidebarTitle":"WebSockets","href":"/cdn/cdn-resource-options/websockets-allow-permanent-connections-with-the-origin"},{"group":"HTTP headers","expanded":false,"pages":[{"title":"Specify HTTP headers that CDN adds to requests to the origin","sidebarTitle":"Add request headers","href":"/cdn/cdn-resource-options/http-headers/specify-http-headers-that-cdn-adds-to-requests-to-the-origin"},{"title":"Add the Access-Control-Allow-Origin header to the browser response","sidebarTitle":"Activate CORS","href":"/cdn/cdn-resource-options/http-headers/add-the-access-control-allow-origin-header-to-the-browser-response"},{"title":"Add or hide response headers","sidebarTitle":"Configure response headers","href":"/cdn/cdn-resource-options/http-headers/add-or-hide-response-headers"},{"title":"Configure and check the host header","sidebarTitle":"Manage the host header","href":"/cdn/cdn-resource-options/http-headers/configure-and-check-the-host-header"},{"title":"Identify the client protocol with X-Forwarded-Proto","sidebarTitle":"Identify a user's request protocol","href":"/cdn/cdn-resource-options/http-headers/use-the-x-forwarded-proto-header-to-identify-the-protocol-used-for-cdn-servers-requests"}]},{"title":"Network limits: set the content delivery speed to end users","sidebarTitle":"Network limits","href":"/cdn/cdn-resource-options/network-limits-set-the-content-delivery-speed-to-end-users"},{"group":"Image optimization (paid)","expanded":false,"pages":[{"title":"About Image Stack","sidebarTitle":"Image Stack overview","href":"/cdn/cdn-resource-options/image-optimization-paid/about-image-stack"},{"title":"Enable Image Stack","sidebarTitle":"Enable Image Stack","href":"/cdn/cdn-resource-options/image-optimization-paid/enable-image-stack"},{"group":"Image stack tools","expanded":false,"pages":[{"title":"Configure image compression to WebP and AVIF","sidebarTitle":"Convert to WebP or AVIF","href":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/configure-image-compression-to-webp-and-avif"},{"title":"Change image quality","sidebarTitle":"Change quality","description":"Reduce CDN image quality with Gcore Image Stack presets or URL query parameters for JPG and PNG delivery.","href":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/change-image-quality"},{"title":"Crop images","sidebarTitle":"Crop","href":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/crop-images"},{"title":"Reduce image size","sidebarTitle":"Resize","description":"Reduce image size by adding Resize query parameters to image URLs, with Image Stack enabled on the CDN.","href":"/cdn/cdn-resource-options/image-optimization-paid/image-stack-tools/reduce-image-size"}]},{"title":"Possible Image Stack errors","sidebarTitle":"Troubleshooting","href":"/cdn/cdn-resource-options/image-optimization-paid/possible-image-stack-errors"}]},{"title":"Query String Forwarding: forward parameters to sub-requests","sidebarTitle":"Query String Forwarding","href":"/cdn/cdn-resource-options/query-string-forwarding"},{"group":"Rules for particular files","expanded":false,"pages":[{"title":"Create a rule manually or from a template to configure settings for particular files","sidebarTitle":"Create a rule","href":"/cdn/cdn-resource-options/rules-for-particular-files/create-a-rule-manually-or-from-a-template-to-configure-settings-for-particular-files"},{"title":"Create and use CDN rule templates","sidebarTitle":"Rule templates","href":"/cdn/cdn-resource-options/rules-for-particular-files/create-a-cdn-resource-rule-template-manually-or-use-a-system-one"},{"title":"Block crawling of a CDN domain","sidebarTitle":"Block crawling","href":"/cdn/cdn-resource-options/rules-for-particular-files/set-robots-txt-to-avoid-adding-to-index-by-web-crawlers"}]}]},{"title":"CDN cache purging and purge history","sidebarTitle":"Purge","href":"/cdn/clear-cdn-resource-cache-by-url-pattern-or-all"},{"title":"CDN billing","sidebarTitle":"Billing","href":"/cdn/how-the-cdn-service-and-its-additional-options-are-billed"},{"group":"IP configuration options","expanded":false,"pages":[{"title":"Bring Your Own IP","sidebarTitle":"BYOIP/BYOASN","href":"/cdn/ip-configuration-options/byoip"},{"title":"Dedicated IP","sidebarTitle":"Dedicated IP","href":"/cdn/ip-configuration-options/dedicated-ip"}]},{"title":"CDN content prefetching","sidebarTitle":"Prefetch","href":"/cdn/load-the-content-to-cdn-before-users-request-it"},{"group":"Logs","expanded":false,"pages":[{"title":"Logs Uploader","href":"/cdn/logs/logs-uploader"},{"title":"Raw Logs export","sidebarTitle":"Raw Logs","href":"/cdn/logs/raw-logs-export-cdn-resource-logs-to-your-storage"},{"title":"CDN resource logs in Log viewer","sidebarTitle":"Log viewer","href":"/cdn/logs/log-viewer-view-and-download-cdn-resource-logs"}]},{"group":"SSL certificates","expanded":false,"pages":[{"title":"Add an SSL certificate to deliver content over HTTPS","sidebarTitle":"SSL overview","href":"/cdn/ssl-certificates/add-an-ssl-certificate-to-deliver-content-over-https"},{"title":"Custom SSL certificate configuration","sidebarTitle":"Custom SSL certificate","href":"/cdn/ssl-certificates/configure-your-own-ssl-certificate"},{"group":"Let's Encrypt certificates","expanded":false,"pages":[{"title":"Configure a Let's Encrypt certificate","sidebarTitle":"Configure","href":"/cdn/ssl-certificates/configure-a-lets-encrypt-certificate"},{"title":"Use DNS-01 for a Let's Encrypt certificate","sidebarTitle":"DNS-01 validation","href":"/cdn/ssl-certificates/use-dns-01-for-a-lets-encrypt-certificate"},{"title":"Renew or revoke a Let's Encrypt certificate","sidebarTitle":"Renew or revoke","href":"/cdn/ssl-certificates/renew-or-revoke-a-lets-encrypt-certificate"}]}]},{"group":"Terraform","expanded":false,"pages":[{"title":"Manage CDN resources with Terraform v0","sidebarTitle":"Manage via Terraform v0","href":"/cdn/terraform/manage-cdn-via-terraform"}]},{"group":"Troubleshooting","expanded":false,"pages":[{"title":"Common setup issues","sidebarTitle":"Common setup issues","href":"/cdn/troubleshooting/common-setup-issues"},{"title":"Gcore CDN error status codes","sidebarTitle":"Error status codes","href":"/cdn/troubleshooting/gcore-error-status-codes"},{"title":"Traceparent header for troubleshooting","sidebarTitle":"Traceparent","href":"/cdn/troubleshooting/traceparent-header-for-troubleshooting"},{"title":"Diagnose CDN routing and connectivity","sidebarTitle":"CDN Debug","href":"/cdn/troubleshooting/diagnose-cdn-routing-and-connectivity"},{"title":"Unavailable content after CDN resource creation","sidebarTitle":"Content unavailability","href":"/cdn/troubleshooting/content-is-unavailable-after-a-cdn-resource-creation-how-to-solve-the-issue"},{"title":"Low cache hit ratio troubleshooting","sidebarTitle":"Low cache hit ratio","href":"/cdn/troubleshooting/cache-percentage-is-low-how-to-solve-the-issue"},{"title":"Slow content delivery troubleshooting","sidebarTitle":"Low content delivery speed","href":"/cdn/troubleshooting/content-delivery-speed-is-low-how-to-solve-the-issue"},{"title":"An SSL certificate isn't working: how to solve the issue","sidebarTitle":"Attaching or issuing an SSL certificate","href":"/cdn/troubleshooting/an-ssl-certificate-isn-t-working-how-to-solve-to-issue"},{"title":"CDN 3xx response troubleshooting","sidebarTitle":"3xx error","href":"/cdn/troubleshooting/3xx-error-how-to-solve-cdn-issues-with-redirect"},{"title":"CDN 4xx response troubleshooting","sidebarTitle":"4xx error","href":"/cdn/troubleshooting/4xx-error-how-to-solve-cdn-issues-with-the-limited-access-and-content-non-existence"},{"title":"CDN 5xx response troubleshooting","sidebarTitle":"5xx error","href":"/cdn/troubleshooting/5xx-error-how-to-solve-server-issues"}]},{"group":"Video CDN","expanded":false,"pages":[{"title":"Video CDN Overview","sidebarTitle":"Overview","href":"/cdn/video-cdn/video-cdn-overview"},{"title":"Common Media Client Data (CMCD)","sidebarTitle":"CMCD","href":"/cdn/video-cdn/cmcd"},{"title":"HLS and LL-HLS via CDN","sidebarTitle":"HLS","href":"/cdn/video-cdn/hls"},{"title":"Improve video delivery speed for low-traffic accounts","sidebarTitle":"Improve delivery speed","href":"/cdn/video-cdn/improve-video-delivery-speed"},{"title":"DASH and LL-DASH via CDN","sidebarTitle":"MPEG-DASH","href":"/cdn/video-cdn/dash"},{"title":"Multi-codec VOD delivery over CDN","sidebarTitle":"Multi-codec H.264, HEVC, AV1, VP9","href":"/cdn/video-cdn/multi-codec-vod-delivery"},{"title":"Origin shielding for video delivery","sidebarTitle":"Origin shielding","href":"/cdn/video-cdn/origin-shielding-for-video"},{"title":"Secure Token for Video CDN","sidebarTitle":"Secure token for video","href":"/cdn/video-cdn/secure-token"},{"title":"Auto-refresh CDN secure tokens","sidebarTitle":"Token auto-refresh","href":"/cdn/video-cdn/secure-token-auto-refresh"},{"title":"Troubleshoot video delivery","sidebarTitle":"Troubleshooting","href":"/cdn/video-cdn/troubleshoot-video-delivery"},{"title":"HTTP-FLV Live and VOD Delivery","sidebarTitle":"Zero-delay FLV Live \u0026 VOD","href":"/cdn/video-cdn/flv-streaming"}]},{"title":"CDN reports and overview","sidebarTitle":"Reports","href":"/cdn/view-statistics-of-a-cdn-resource"},{"group":"Grafana","expanded":false,"pages":[{"title":"View CDN statistics in Grafana","sidebarTitle":"Grafana reports","href":"/cdn/grafana/view-cdn-statistics-in-grafana"}]}]},{"group":"FastEdge","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/fastedge"},{"group":"Get started","expanded":false,"pages":[{"title":"FastEdge overview","sidebarTitle":"Overview","href":"/fastedge/getting-started"},{"title":"Set up Rust for FastEdge","sidebarTitle":"Rust (Modern HTTP)","href":"/fastedge/getting-started/setup-rust-modern"},{"title":"Set up Rust for FastEdge","sidebarTitle":"Rust (Legacy HTTP)","href":"/fastedge/getting-started/setup-rust-legacy"},{"title":"Set up JavaScript for FastEdge","sidebarTitle":"JavaScript","href":"/fastedge/getting-started/setup-javascript"},{"title":"Set up Rust for FastEdge CDN apps","sidebarTitle":"Rust (CDN / Proxy-Wasm)","href":"/fastedge/getting-started/setup-rust-cdn"}]},{"group":"Applications","expanded":false,"pages":[{"group":"HTTP Applications","expanded":false,"pages":[{"title":"Create FastEdge HTTP applications","sidebarTitle":"HTTP applications","href":"/fastedge/getting-started/create-fastedge-apps"},{"title":"Render Markdown at the edge","sidebarTitle":"Markdown renderer","href":"/fastedge/render-markdown"},{"title":"Redirect visitors by location","sidebarTitle":"Geolocation redirect","href":"/fastedge/geolocation-redirect"},{"title":"Build a FastEdge HTTP application","sidebarTitle":"Build an HTTP app","href":"/fastedge/getting-started/get-started-http"},{"title":"Call an external API from a FastEdge app","sidebarTitle":"Call an external API","href":"/fastedge/getting-started/call-external-api-rust"}]},{"group":"CDN Applications","expanded":false,"pages":[{"title":"Build and deploy a FastEdge CDN application","sidebarTitle":"Build a CDN app","href":"/fastedge/getting-started/get-started-cdn"},{"title":"Run several checks in one CDN application","sidebarTitle":"Several checks, one app","href":"/fastedge/getting-started/combine-checks-in-one-cdn-app"},{"title":"Request and response properties","sidebarTitle":"Request and response properties","href":"/fastedge/getting-started/cdn-properties"}]},{"title":"FastEdge application management","sidebarTitle":"FastEdge application management","href":"/fastedge/manage-apps"},{"title":"Create and manage templates","sidebarTitle":"Create and manage templates","href":"/fastedge/create-manage-templates"}]},{"group":"Local development","expanded":false,"pages":[{"title":"Local development for FastEdge","sidebarTitle":"Overview","href":"/fastedge/local-development/overview"},{"group":"AI-assisted development","pages":[{"title":"Get started with AI-assisted FastEdge development","sidebarTitle":"Get started","href":"/fastedge/local-development/ai-assisted-development"},{"title":"Configure the FastEdge plugin and MCP server","sidebarTitle":"Configure plugin and MCP","href":"/fastedge/local-development/configure-plugin-and-mcp-server"},{"title":"FastEdge AI skills reference","sidebarTitle":"Skills reference","href":"/fastedge/local-development/ai-skills-reference"}]},{"title":"FastEdge extension for VS Code","sidebarTitle":"VS Code extension","href":"/fastedge/local-development/vscode-extension"},{"title":"Test framework for FastEdge","sidebarTitle":"Test framework","href":"/fastedge/local-development/test-framework"},{"title":"FastEdge CLI","sidebarTitle":"FastEdge CLI","href":"/fastedge/fastedge-cli"}]},{"group":"Secrets Manager","expanded":false,"pages":[{"title":"Secrets Manager","sidebarTitle":"Manage secrets","href":"/fastedge/secrets-manager/manage-secrets"},{"title":"Secret rotation with slots","sidebarTitle":"Secret rotation with slots","href":"/fastedge/secrets-manager/slots"}]},{"group":"Edge Storage","expanded":false,"pages":[{"title":"How it works","sidebarTitle":"How it works","href":"/fastedge/kv-stores/how-it-works"},{"title":"Edge Storage","sidebarTitle":"Manage Edge Storage","href":"/fastedge/kv-stores/manage-kv-store"},{"title":"BYOD — Bring Your Own Database","sidebarTitle":"BYOD","href":"/fastedge/kv-stores/byod"},{"title":"Sorted Set","sidebarTitle":"Sorted Set","href":"/fastedge/kv-stores/sorted-set"},{"title":"Bloom Filter","sidebarTitle":"Bloom Filter","href":"/fastedge/kv-stores/bloom-filter"}]},{"title":"Cache","sidebarTitle":"Cache","href":"/fastedge/cache"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/fastedge/troubleshooting"},{"group":"Grafana","expanded":false,"pages":[{"title":"View FastEdge statistics in Grafana","sidebarTitle":"Grafana reports","href":"/fastedge/grafana/view-fastedge-statistics-in-grafana"}]}]},{"group":"Edge Cloud","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/cloud"},{"title":"Bandwidth and traffic","href":"/cloud/bandwidth-and-traffic"},{"title":"Billing","sidebarTitle":"Billing","href":"/cloud/billing"},{"title":"Tags","sidebarTitle":"Tags","href":"/cloud/tags"},{"group":"Getting started","expanded":false,"pages":[{"title":"Manage resource quotas","sidebarTitle":"Quotas","href":"/cloud/getting-started/request-a-quota-increase"},{"group":"Projects","expanded":false,"pages":[{"title":"Create and manage projects","sidebarTitle":"Create a project","href":"/cloud/getting-started/projects/create-a-project"},{"group":"Users","expanded":false,"pages":[{"title":"User roles and rights","sidebarTitle":"User roles","href":"/cloud/getting-started/projects/users/user-roles-and-rights"},{"title":"Add users to a project","sidebarTitle":"Add a user","href":"/cloud/getting-started/projects/users/add-a-new-user-to-your-project"},{"title":"Manage user access","sidebarTitle":"Manage access","href":"/cloud/getting-started/projects/users/manage-user-access-to-your-project"},{"title":"View user actions","sidebarTitle":"View user actions","href":"/cloud/getting-started/projects/users/view-user-actions"}]}]},{"title":"Cost reports","sidebarTitle":"Cost reports","href":"/cloud/getting-started/view-statistics-on-expenses"}]},{"group":"Virtual Machines","expanded":false,"pages":[{"title":"Types of Virtual Machines","sidebarTitle":"Types of Virtual Machines","href":"/cloud/virtual-instances/types-of-virtual-machines"},{"title":"Create a Basic VM","sidebarTitle":"Create a Basic VM","href":"/cloud/virtual-instances/create-a-basic-vm"},{"title":"Create a virtual instance","sidebarTitle":"Create an instance","href":"/cloud/virtual-instances/create-an-instance"},{"title":"Rebuild a virtual instance","sidebarTitle":"Rebuild an instance","href":"/cloud/virtual-instances/rebuild-a-virtual-instance"},{"title":"Customize the initial setup for a Virtual Machine","sidebarTitle":"Customize initial setup","href":"/cloud/virtual-instances/customize-initial-setup-for-your-instance"},{"title":"Check the operational status of a Virtual Machine","sidebarTitle":"Check the status","href":"/cloud/virtual-instances/check-the-operational-status-of-your-instance"},{"title":"Enable root user on a Linux VM","sidebarTitle":"Enable root user","href":"/cloud/virtual-instances/enable-root-user-on-a-linux-vm"},{"group":"Connect","expanded":false,"pages":[{"title":"Connect to a Virtual Machine via the Gcore customer portal","sidebarTitle":"Connect via customer portal","href":"/cloud/virtual-instances/connect/connect-to-your-instance-via-control-panel"},{"group":"Connect via SSH","expanded":false,"pages":[{"title":"Connect to a Virtual Machine via SSH","sidebarTitle":"Connect via SSH","href":"/cloud/virtual-instances/connect/connect-via-ssh"},{"title":"Configure and manage SSH keys","sidebarTitle":"Configure and manage SSH keys","href":"/cloud/virtual-instances/connect/connect-to-your-instance-via-ssh"},{"title":"Convert an SSH key to PPK format","sidebarTitle":"Convert an SSH key to PPK format","href":"/cloud/ssh-keys/convert-an-ssh-key-from-pem-to-ppk"},{"title":"Establish SSH connection to a Virtual Instance","sidebarTitle":"Establish SSH connection to a Virtual Instance","href":"/cloud/virtual-instances/connect/establish-ssh-connection-to-an-instance"}]}]},{"group":"Placement groups","expanded":false,"pages":[{"title":"About placement groups","sidebarTitle":"Overview","href":"/cloud/virtual-instances/placement-groups/about-placement-groups"},{"title":"Configure a placement group","sidebarTitle":"Configure","href":"/cloud/virtual-instances/placement-groups/configure-a-placement-group"}]},{"group":"Volumes","expanded":false,"pages":[{"title":"Volumes","sidebarTitle":"Overview","href":"/cloud/virtual-instances/volumes/about-volumes"},{"title":"Create a volume","sidebarTitle":"Create a volume","href":"/cloud/virtual-instances/volumes/create-a-volume"},{"title":"Manage a volume","sidebarTitle":"Manage a volume","href":"/cloud/virtual-instances/volumes/manage-a-volume"}]},{"title":"Monitor load and performance of a Virtual Machine","sidebarTitle":"Monitor","href":"/cloud/virtual-instances/monitor-load-and-performance-of-your-instance"},{"group":"Snapshots","expanded":false,"pages":[{"title":"Take a snapshot of your file system","sidebarTitle":"Take a snapshot","href":"/cloud/virtual-instances/snapshots/take-a-snapshot-of-your-file-system"},{"title":"Set up automatic snapshot creation","sidebarTitle":"Set up automatic snapshots","href":"/cloud/virtual-instances/snapshots/set-up-automatic-snapshot-creation"}]},{"group":"Troubleshooting","expanded":false,"pages":[{"title":"Troubleshoot issues with an SSH connection","sidebarTitle":"SSH connection","href":"/cloud/virtual-instances/troubleshooting/troubleshoot-issues-with-ssh-connection"},{"title":"Recover SSH access in recovery mode","sidebarTitle":"Recovery mode","href":"/cloud/virtual-instances/troubleshooting/recover-ssh-access-via-recovery-mode"}]}]},{"group":"Bare Metal servers","expanded":false,"pages":[{"title":"About Bare Metal","sidebarTitle":"About BM servers","href":"/cloud/bare-metal-servers/about-bare-metal-servers"},{"title":"Types of Bare Metal servers","sidebarTitle":"Types of BM servers","href":"/cloud/bare-metal-servers/types-of-bare-metal-servers"},{"title":"Create a Bare Metal server","sidebarTitle":"Create a server","href":"/cloud/bare-metal-servers/create-a-bare-metal-server"},{"title":"Manage a Bare Metal server","sidebarTitle":"Manage a server","href":"/cloud/bare-metal-servers/manage-a-bare-metal-server"},{"title":"Connect to Bare Metal via SSH","sidebarTitle":"Connect via SSH","href":"/cloud/bare-metal-servers/connect-to-your-bare-metal-server-via-ssh"},{"title":"Bare Metal egress traffic","sidebarTitle":"Egress traffic","href":"/cloud/bare-metal-servers/egress-traffic"},{"group":"Troubleshooting","expanded":false,"pages":[{"title":"Troubleshoot issues with an SSH connection","sidebarTitle":"SSH connection","href":"/cloud/virtual-instances/troubleshooting/troubleshoot-issues-with-ssh-connection"}]},{"group":"Advanced DDoS protection","expanded":false,"pages":[{"title":"About advanced DDoS protection for Bare Metal","href":"/cloud/bare-metal-servers/advanced-ddos-protection/about-advanced-ddos-protection-for-bare-metal-servers"},{"title":"Activate advanced DDoS protection for Bare Metal","sidebarTitle":"Activate Advanced DDoS Protection","href":"/cloud/bare-metal-servers/advanced-ddos-protection/activate-advanced-ddos-protection-for-bare-metal-servers"}]}]},{"group":"Images","expanded":false,"pages":[{"title":"About images","sidebarTitle":"Overview","href":"/cloud/images/about-images"},{"title":"Upload a custom image","sidebarTitle":"Upload","href":"/cloud/images/upload-an-image-to-the-storage"},{"title":"Manage custom images","sidebarTitle":"Manage","href":"/cloud/images/manage-custom-images"}]},{"group":"Networking","expanded":false,"pages":[{"title":"Create and manage a network","sidebarTitle":"Network","href":"/cloud/networking/create-and-manage-a-network"},{"title":"Create and manage a subnet","sidebarTitle":"Subnet","href":"/cloud/networking/create-and-manage-a-subnetwork"},{"title":"Create and manage a router","sidebarTitle":"Router","href":"/cloud/networking/create-and-manage-a-router"},{"group":"IP address","expanded":false,"pages":[{"title":"Create and configure a floating IP address","sidebarTitle":"Floating IP address","href":"/cloud/networking/ip-address/create-and-configure-a-floating-ip-address"},{"title":"Create and configure a reserved IP address","sidebarTitle":"Reserved IP address","href":"/cloud/networking/ip-address/create-and-configure-a-reserved-ip-address"},{"title":"Create and configure a virtual IP address","sidebarTitle":"Virtual IP address","href":"/cloud/networking/ip-address/create-and-configure-a-virtual-ip-vip-address"},{"title":"Difference between virtual, floating, and reserved IP addresses","sidebarTitle":"IP address types","href":"/cloud/networking/ip-address/difference-between-virtual-floating-and-reserved-ip-addresses"},{"title":"Configure an allowed address pair","sidebarTitle":"Allowed address pair","href":"/cloud/networking/ip-address/configure-an-allowed-address-pair"}]},{"group":"Load balancers","expanded":false,"pages":[{"title":"Create and configure a load balancer","sidebarTitle":"Create load balancer","href":"/cloud/networking/create-and-configure-a-load-balancer"},{"title":"Add TLS certificates to a load balancer","sidebarTitle":"Add TLS certificates to a load balancer","href":"/cloud/networking/load-balancers/add-certificates-to-load-balancer"},{"title":"Configure mutual TLS authentication","sidebarTitle":"Configure mutual TLS authentication","href":"/cloud/networking/load-balancers/configure-mtls-authentication"},{"title":"Manage load balancers","href":"/cloud/networking/load-balancers/manage-load-balancers"},{"title":"Logging for load balancers","sidebarTitle":"Logging","href":"/cloud/networking/load-balancers/logging-for-load-balancers"},{"title":"Use annotations for load balancers","sidebarTitle":"Annotations","href":"/cloud/networking/load-balancers/use-annotations-for-load-balancers"},{"title":"Monitoring for load balancers","sidebarTitle":"Monitoring","href":"/cloud/networking/load-balancers/monitoring-for-load-balancers"}]},{"title":"Add and configure a security group","sidebarTitle":"Security Group","href":"/cloud/networking/add-and-configure-a-firewall"},{"title":"Bring Your Own IP (BYOIP)","href":"/cloud/networking/byoip"},{"title":"Cloud egress IP addresses","sidebarTitle":"Egress IP addresses","href":"/cloud/networking/cloud-egress-ip-addresses"}]},{"group":"File shares","expanded":false,"pages":[{"title":"About file shares","sidebarTitle":"Overview","href":"/cloud/file-shares/about-file-shares"},{"title":"Configuring file shares","sidebarTitle":"Configure","href":"/cloud/file-shares/configure-file-shares"},{"title":"Resize file shares for Managed Kubernetes","sidebarTitle":"Resize for Kubernetes","href":"/cloud/file-shares/resize-file-shares-for-kubernetes"},{"title":"Migrate data from S3 and EFS to Gcore","sidebarTitle":"Migrate from S3 and EFS","href":"/cloud/file-shares/how-to-migrate-data-from-s3"}]},{"group":"Managed Kubernetes","expanded":false,"pages":[{"title":"About Gcore Managed Kubernetes","sidebarTitle":"Overview","href":"/cloud/kubernetes/about-gcore-kubernetes"},{"title":"Bare Metal Kubernetes","sidebarTitle":"Bare Metal support","href":"/cloud/kubernetes/bare-metal-kubernetes"},{"group":"Clusters","expanded":false,"pages":[{"title":"Create a Kubernetes cluster","sidebarTitle":"Create","href":"/cloud/kubernetes/clusters/create-a-kubernetes-cluster"},{"title":"Upgrade a Kubernetes cluster","sidebarTitle":"Upgrade","href":"/cloud/kubernetes/clusters/upgrade"},{"group":"Connect","expanded":false,"pages":[{"title":"Connect to your nodes via SSH","sidebarTitle":"SSH connection","href":"/cloud/kubernetes/clusters/connect/connect-to-your-nodes-via-ssh-using-a-floating-ip-address"},{"title":"Install kubectl and connect to a Kubernetes cluster","sidebarTitle":"kubectl","href":"/cloud/kubernetes/clusters/connect/install-kubectl-and-connect-to-a-kubernetes-cluster"}]},{"title":"Secure Kubernetes cluster with OpenID Connect","sidebarTitle":"Secure cluster with OpenID Connect","href":"/cloud/kubernetes/clusters/secure-cluster-with-oidc"},{"group":"Autoscaling","expanded":false,"pages":[{"title":"About autoscaling","sidebarTitle":"Overview","href":"/cloud/kubernetes/clusters/autoscaling/about-autoscaling"},{"title":"Change autoscaling limits","sidebarTitle":"Change limits","href":"/cloud/kubernetes/clusters/autoscaling/change-autoscaling-limits"},{"title":"Create and configure a pool","sidebarTitle":"Create and configure a pool","href":"/cloud/kubernetes/clusters/autoscaling/create-a-new-pool-in-cluster"},{"title":"Advanced cluster autoscaler settings","sidebarTitle":"Advanced autoscaler settings","href":"/cloud/kubernetes/clusters/autoscaling/advanced-cluster-autoscaler-settings"},{"title":"Configure GPU autoscaling for Kubernetes","sidebarTitle":"Configure GPU autoscaling for Kubernetes","href":"/cloud/kubernetes/clusters/autoscaling/configure-gpu-autoscaling-for-kubernetes"}]},{"title":"Add users with limited rights to a Kubernetes cluster","sidebarTitle":"Add users with limited rights to a Kubernetes cluster","href":"/cloud/kubernetes/clusters/add-users-with-limited-rights-to-a-kubernetes-cluster"}]},{"title":"Monitor load on a specific node","sidebarTitle":"Monitor load on a specific node","href":"/cloud/kubernetes/monitor-load-on-a-specific-node"},{"group":"Networking","expanded":false,"pages":[{"title":"About networking in Kubernetes","sidebarTitle":"Overview","href":"/cloud/kubernetes/networking/about-networking-in-kubernetes"},{"title":"Install nginx Ingress controller","sidebarTitle":"Install nginx controller","href":"/cloud/kubernetes/networking/install-and-set-up-the-nginx-ingress-controller"},{"title":"Use Nginx Ingress Controller","sidebarTitle":"Use Nginx Controller","href":"/cloud/kubernetes/networking/use-the-nginx-ingress-controller"}]},{"group":"Storage","expanded":false,"pages":[{"title":"Create a PVC and bind to a pod","sidebarTitle":"Create a PVC and bind it to a pod","href":"/cloud/kubernetes/storage/create-a-pvc-and-bind-it-to-a-pod"},{"title":"Configure NFS storage for Managed Kubernetes","sidebarTitle":"Configure NFS storage","href":"/cloud/kubernetes/storage/configure-nfs-csi-driver-for-kubernetes"}]},{"title":"Troubleshooting a node in a \"Not Ready\" state","sidebarTitle":"Troubleshooting a \"Not Ready\" state","href":"/cloud/kubernetes/troubleshooting-not-ready-state"}]},{"group":"Managed PostgreSQL","expanded":false,"pages":[{"title":"About managed PostgreSQL","sidebarTitle":"Managed PostgreSQL","href":"/cloud/managed-database-postgresql"},{"title":"Manage a PostgreSQL server","sidebarTitle":"Manage PostgreSQL servers","href":"/cloud/managed-database-postgresql/manage-postgresql-servers"},{"title":"Backup and restore PostgreSQL database for Managed PostgreSQL using external utilities","sidebarTitle":"Backup and restore","href":"/cloud/managed-database-postgresql/backup-and-restore-postgresql-database-for-gcore-managed-database-for-postgresql-using-external-utilities"}]},{"group":"Secrets manager","expanded":false,"pages":[{"title":"Configure secrets for HTTPS load balancer","sidebarTitle":"Configure secrets","href":"/cloud/secrets-manager/upload-a-pkcs12-file"}]},{"group":"Function as a service","expanded":false,"pages":[{"title":"About Function as a Service","sidebarTitle":"Function as a Service","href":"/cloud/faas/about-function-as-a-service"},{"title":"Authenticate to functions with API keys","sidebarTitle":"Authenticate to functions with API keys","href":"/cloud/faas/authenticate-to-functions-with-api-keys"},{"title":"Code examples for supported FaaS runtimes","sidebarTitle":"Function examples","href":"/cloud/faas/code-examples-for-supported-faas-runtimes"}]},{"group":"Container as a service","expanded":false,"pages":[{"title":"About container as a service","sidebarTitle":"Container as a service","href":"/cloud/caas"},{"title":"Create a container","href":"/cloud/caas/create-a-container"},{"title":"Use a private container registry","sidebarTitle":"Use a private registry","href":"/cloud/caas/use-a-private-registry"},{"title":"Build and deploy containers to CaaS via GitHub Actions","sidebarTitle":"Deploy via GitHub Actions","href":"/cloud/caas/build-and-deploy-containers-to-caas-via-github-actions"},{"title":"Manage containers","sidebarTitle":"Manage containers","href":"/cloud/caas/manage-containers"}]},{"group":"Container registry","expanded":false,"pages":[{"title":"Container registry","href":"/cloud/container-registry"},{"title":"Create a Container Registry","sidebarTitle":"Create a Container Registry","href":"/cloud/container-registry/create-container-registry"},{"title":"Manage container registries","sidebarTitle":"Manage container registries","href":"/cloud/container-registry/manage-container-registries"}]},{"group":"Managed logging","expanded":false,"pages":[{"title":"About managed logging","sidebarTitle":"Overview","href":"/cloud/logging-as-a-service/about-logging-as-a-service"},{"title":"Configure logging and view logs","sidebarTitle":"Configure","href":"/cloud/logging-as-a-service/configure-logging-and-view-your-logs"},{"group":"Install a log shipper","expanded":false,"pages":[{"title":"Install and configure Filebeat","sidebarTitle":"Filebeat","href":"/cloud/logging-as-a-service/install-a-log-shipper/install-and-configure-filebeat"},{"title":"Install and configure Fluent Bit","sidebarTitle":"Fluent Bit","href":"/cloud/logging-as-a-service/install-a-log-shipper/install-and-configure-fluent-bit"},{"title":"Install and configure Fluentd","sidebarTitle":"Fluentd","href":"/cloud/logging-as-a-service/install-a-log-shipper/install-and-configure-fluentd"},{"title":"Install and configure Logstash","sidebarTitle":"Logstash","href":"/cloud/logging-as-a-service/install-a-log-shipper/install-and-configure-logstash"}]},{"title":"Prometheus exporter","sidebarTitle":"Prometheus exporter","href":"/cloud/logging-as-a-service/prometheus-exporter"},{"title":"View Gcore Managed Logging data in Grafana with OpenSearch plugin","sidebarTitle":"View logs in Grafana with OpenSearch plugin","href":"/cloud/logging-as-a-service/view-opensearch-logs-in-Grafana"}]},{"group":"Terraform","expanded":false,"pages":[{"title":"Manage Cloud resources via Terraform v0","sidebarTitle":"Manage via Terraform v0","href":"/cloud/manage-cloud-via-terraform"}]},{"title":"Manage cloud resources via Ansible","sidebarTitle":"Ansible","href":"/cloud/manage-cloud-via-ansible"},{"group":"Use cases","expanded":false,"pages":[{"title":"Set up a mailing server in a Gcore Cloud VM","sidebarTitle":"Set up a mailing server","href":"/cloud/use-cases/set-up-a-mailing-server-in-gcore-cloud-vm"}]}]},{"group":"AI","pages":[{"title":"Overview","href":"/edge-ai"},{"title":"Getting started","sidebarTitle":"Getting started","href":"/edge-ai/getting-started"},{"title":"Billing","sidebarTitle":"Billing","href":"/edge-ai/billing"},{"group":"Everywhere Inference","expanded":false,"pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/edge-ai/everywhere-inference"},{"title":"Application Catalog","sidebarTitle":"Application Catalog","href":"/edge-ai/everywhere-inference/application-catalog"},{"group":"AI models","expanded":false,"pages":[{"title":"Deploy a model from the Application Catalog","sidebarTitle":"Deploy from catalog","href":"/edge-ai/everywhere-inference/ai-models/deploy-from-catalog"},{"title":"Prepare a custom AI model for deployment","sidebarTitle":"Prepare a custom AI model for deployment","href":"/edge-ai/everywhere-inference/ai-models/prepare-a-custom-ai-model-for-deployment"},{"title":"Deploy a custom model","sidebarTitle":"Deploy a custom model","href":"/edge-ai/everywhere-inference/ai-models/deploy-a-custom-model"},{"title":"Manage AI model deployments","sidebarTitle":"Manage AI model deployments","href":"/edge-ai/everywhere-inference/ai-models/manage-ai-model-deployments"},{"title":"Query a deployed model","sidebarTitle":"Query deployed model","href":"/edge-ai/everywhere-inference/ai-models/query-deployed-model"},{"title":"Chat with a model via Open WebUI","sidebarTitle":"Chat via Open WebUI","href":"/edge-ai/everywhere-inference/ai-models/chat-with-open-webui"},{"title":"Translate text with Llama 3.2","sidebarTitle":"Translate text","href":"/edge-ai/everywhere-inference/ai-models/translate-text-with-llama"}]},{"group":"Container image registries","expanded":false,"pages":[{"title":"Add a container image registry","sidebarTitle":"Add a registry","href":"/edge-ai/everywhere-inference/container-image-registries/add-a-registry"},{"title":"Manage container image registries","sidebarTitle":"Manage registries","href":"/edge-ai/everywhere-inference/container-image-registries/manage-registries"}]},{"group":"API keys","expanded":false,"pages":[{"title":"Inference deployment with API key authentication","sidebarTitle":"Inference deployment with API key authentication","href":"/edge-ai/everywhere-inference/api-keys/create-inference-deployment-with-auth"}]},{"group":"Quotas","expanded":false,"pages":[{"title":"Request a quota increase","sidebarTitle":"Request quota increase","href":"/edge-ai/everywhere-inference/quotas/request-quota-increase"},{"title":"Quotas Request History","sidebarTitle":"Quotas Request History","href":"/edge-ai/everywhere-inference/quotas/quotas-request-history"}]}]},{"group":"GPU Cloud","expanded":false,"pages":[{"title":"About GPU Cloud","sidebarTitle":"About GPU Cloud","href":"/edge-ai/ai-infrastructure/about-gpu-cloud"},{"title":"Create a Virtual GPU cluster","sidebarTitle":"Create a Virtual GPU cluster","href":"/edge-ai/ai-infrastructure/create-a-virtual-gpu-cluster"},{"title":"Manage a Virtual GPU cluster","sidebarTitle":"Manage a Virtual GPU cluster","href":"/edge-ai/ai-infrastructure/manage-a-virtual-gpu-cluster"},{"title":"Create a Bare Metal GPU cluster","sidebarTitle":"Create a Bare Metal GPU cluster","href":"/edge-ai/ai-infrastructure/create-a-bare-metal-gpu-cluster"},{"title":"Manage a Bare Metal GPU cluster","sidebarTitle":"Manage a Bare Metal GPU cluster","href":"/edge-ai/ai-infrastructure/manage-a-bare-metal-gpu-cluster"},{"title":"Spot Bare Metal GPU","sidebarTitle":"Spot Bare Metal GPU","href":"/edge-ai/ai-infrastructure/spot-bare-metal-gpu"}]},{"group":"Storage","expanded":false,"pages":[{"title":"Create and manage volumes","sidebarTitle":"Volumes","href":"/edge-ai/storage/create-and-manage-volumes"},{"title":"Create and manage file shares","sidebarTitle":"File shares","href":"/edge-ai/storage/create-and-manage-file-shares"}]},{"group":"Networking","expanded":false,"pages":[{"title":"About GPU Cloud networking","sidebarTitle":"About networking","href":"/edge-ai/networking/about-gpu-cloud-networking"},{"title":"InfiniBand networking","sidebarTitle":"InfiniBand","href":"/edge-ai/networking/about-infiniband"},{"title":"Create and manage a network","sidebarTitle":"Network","href":"/cloud/networking/create-and-manage-a-network"},{"title":"Create and manage a subnet","sidebarTitle":"Subnet","href":"/cloud/networking/create-and-manage-a-subnetwork"},{"title":"Create and manage a router","sidebarTitle":"Router","href":"/cloud/networking/create-and-manage-a-router"},{"title":"Create and configure a floating IP address","sidebarTitle":"Floating IP address","href":"/cloud/networking/ip-address/create-and-configure-a-floating-ip-address"},{"title":"Add and configure a security group","sidebarTitle":"Security Group","href":"/cloud/networking/add-and-configure-a-firewall"}]},{"group":"Images and SSH keys","expanded":false,"pages":[{"title":"Manage custom images","sidebarTitle":"Manage","href":"/cloud/images/manage-custom-images"},{"title":"Configure and manage SSH keys","sidebarTitle":"Configure and manage SSH keys","href":"/cloud/virtual-instances/connect/connect-to-your-instance-via-ssh"}]},{"group":"Managed Kubernetes","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/edge-ai/managed-kubernetes/overview"},{"title":"Create a GPU Kubernetes cluster","sidebarTitle":"Create a cluster","href":"/edge-ai/managed-kubernetes/create-a-gpu-kubernetes-cluster"},{"group":"Manage a cluster","pages":[{"title":"Connect to a GPU Kubernetes cluster","sidebarTitle":"Connect to a cluster","href":"/edge-ai/managed-kubernetes/connect-to-a-gpu-kubernetes-cluster"},{"title":"Manage node pools","sidebarTitle":"Node pools","href":"/edge-ai/managed-kubernetes/manage-node-pools"},{"title":"Configure cluster autoscaling","sidebarTitle":"Autoscaling","href":"/edge-ai/managed-kubernetes/configure-cluster-autoscaling"},{"title":"Configure cluster logging","sidebarTitle":"Logging","href":"/edge-ai/managed-kubernetes/configure-cluster-logging"},{"title":"Configure OIDC authentication","sidebarTitle":"OIDC authentication","href":"/edge-ai/managed-kubernetes/configure-oidc-authentication"},{"title":"Upgrade a GPU Kubernetes cluster","sidebarTitle":"Upgrade a cluster","href":"/edge-ai/managed-kubernetes/upgrade-a-gpu-kubernetes-cluster"},{"title":"View cluster audit log","sidebarTitle":"Audit log","href":"/edge-ai/managed-kubernetes/view-cluster-audit-log"},{"title":"Delete a GPU Kubernetes cluster","sidebarTitle":"Delete a cluster","href":"/edge-ai/managed-kubernetes/delete-a-gpu-kubernetes-cluster"}]}]}]},{"group":"Gclaw","pages":[{"title":"Gclaw","sidebarTitle":"Overview","href":"/gclaw"},{"title":"Getting started","sidebarTitle":"Getting started","href":"/gclaw/getting-started"},{"title":"Manage instance","sidebarTitle":"Manage instance","href":"/gclaw/manage-instance"},{"title":"Configure API keys","sidebarTitle":"API keys","href":"/gclaw/api-keys"},{"group":"Integrations","expanded":false,"pages":[{"title":"Connect Telegram","sidebarTitle":"Connect Telegram","href":"/gclaw/connect-telegram"},{"title":"Connect Discord","sidebarTitle":"Connect Discord","href":"/gclaw/connect-discord"}]},{"title":"Security model","sidebarTitle":"Security","href":"/gclaw/security"},{"title":"Limits and quotas","sidebarTitle":"Limits","href":"/gclaw/limits"},{"title":"Pricing","sidebarTitle":"Pricing","href":"/gclaw/pricing"},{"title":"SSH access to the Gclaw VM","sidebarTitle":"SSH access","href":"/gclaw/ssh-access"}]},{"group":"Managed DNS","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/dns"},{"title":"DNS packages","sidebarTitle":"DNS packages","href":"/dns/dns-packages"},{"title":"Gcore Managed DNS glossary","sidebarTitle":"Glossary","href":"/dns/gcore-dns-glossary"},{"title":"Getting started with Managed DNS","sidebarTitle":"Getting started (Create a DNS zone)","href":"/dns/manage-a-dns-zone"},{"title":"Migrate DNS from Cloudflare to Gcore","sidebarTitle":"Migrate from Cloudflare","href":"/dns/migrate-from-cloudflare"},{"group":"Records","expanded":false,"pages":[{"title":"Supported DNS record types","sidebarTitle":"Records","href":"/dns/dns-records"},{"title":"Manage DNS records","sidebarTitle":"Manage DNS records","href":"/dns/dns-records/manage-dns-records-non-advanced-interface-mode"},{"title":"Manage DNS records (advanced interface mode with dynamic response)","sidebarTitle":"Advanced managing","href":"/dns/dns-records/manage-dns-records-advanced-interface-mode-with-balancing"},{"title":"Import and export records","sidebarTitle":"Import and export","href":"/dns/dns-records/import-and-export-records"},{"title":"Create records in zone apex (CNAME flattening)","sidebarTitle":"CNAME flattening","href":"/dns/dns-records/specify-cname-at-root"},{"title":"Configure DNS records for email","sidebarTitle":"Email DNS records","href":"/dns/dns-records/set-up-dns-for-sending-email"},{"title":"Setting up a PTR record and reverse DNS zone","sidebarTitle":"PTR record and reverse DNS zone","href":"/dns/dns-records/set-up-a-ptr-record-and-reverse-dns-zone"},{"title":"Configure HTTPS records","sidebarTitle":"HTTPS record","href":"/dns/dns-records/what-is-an-https-record-and-how-is-it-configured"},{"group":"Advanced managing","expanded":false,"pages":[{"title":"Dynamic response","sidebarTitle":"Dynamic response","href":"/dns/dns-records/configure-weight-balancing-and-geobalancing"},{"title":"DNS Healthchecks","sidebarTitle":"Healthchecks","href":"/dns/dns-failover/configure-and-use-dns-failover"},{"title":"Configure CDN integration","sidebarTitle":"CDN integration","href":"/dns/dns-records/advanced-managing/cdn-integration"}]}]},{"title":"Getting started with DNSSEC","sidebarTitle":"DNSSEC","href":"/dns/getting-started-with-dnssec"},{"group":"Integrations","expanded":false,"pages":[{"title":"Configure OctoDNS with Gcore Managed DNS","sidebarTitle":"OctoDNS","href":"/dns/dns-plugins/use-gcore-dns-as-a-secondary-dns-with-octodns"},{"title":"Get a Let's Encrypt certificate with Certbot","sidebarTitle":"Certbot","href":"/dns/dns-plugins/get-a-let-s-encrypt-certificate-with-certbot"},{"title":"Manage DNS zones and records via Terraform v0","sidebarTitle":"Manage via Terraform v0","href":"/dns/dns-plugins/manage-dns-with-terraform"}]},{"group":"Grafana","expanded":false,"pages":[{"title":"View DNS statistics in Grafana","sidebarTitle":"Grafana reports","href":"/dns/grafana/view-dns-statistics-in-grafana"}]}]},{"group":"Public DNS","pages":[{"title":"Public DNS","sidebarTitle":"Overview","href":"/dns/public-dns"},{"title":"Configure a DNS resolver","sidebarTitle":"Configure a DNS resolver","href":"/dns/configure-plain-dns"},{"title":"Configure DNS over HTTPS and DNS over TLS","sidebarTitle":"DNS over HTTPS and DNS over TLS","href":"/dns/configure-doh-and-dot"},{"title":"Troubleshoot Gcore Public DNS","sidebarTitle":"Troubleshooting","href":"/dns/troubleshoot-public-dns"}]},{"group":"Hosting","pages":[{"title":"Hosting","href":"/hosting"},{"group":"Dedicated servers","expanded":false,"pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/hosting/dedicated-servers/about-dedicated-servers"},{"group":"Before purchase","expanded":false,"pages":[{"title":"Test network connectivity before buying a server","sidebarTitle":"Test network performance","href":"/hosting/virtual-servers/before-purchase/test-the-connectivity-between-your-location-and-the-server-you-want-to-buy"}]},{"title":"Order a dedicated server","sidebarTitle":"Order","href":"/hosting/dedicated-servers/order-a-dedicated-server"},{"title":"Upgrade your dedicated server","sidebarTitle":"Upgrade","href":"/hosting/dedicated-servers/upgrade-your-dedicated-server"},{"group":"Manage","expanded":false,"pages":[{"title":"Power a dedicated server on or off","sidebarTitle":"Power on or off","href":"/hosting/dedicated-servers/manage/log-in-to-dcimanager"},{"title":"Log in to IPMI","sidebarTitle":"Log in to IPMI","href":"/hosting/dedicated-servers/manage/log-in-to-ipmi"},{"group":"Connect","expanded":false,"pages":[{"title":"Connect to a Windows server","sidebarTitle":"Windows server","href":"/hosting/dedicated-servers/manage/connect/connect-to-a-windows-server"},{"title":"Connect to a Linux server","sidebarTitle":"Linux server","href":"/hosting/dedicated-servers/manage/connect/connect-to-a-linux-server"},{"title":"Manage SSH keys","sidebarTitle":"SSH keys","href":"/hosting/virtual-servers/manage/connect/linux-server/manage-ssh-keys"},{"title":"Change the port for SSH connections","sidebarTitle":"Change SSH port","href":"/hosting/virtual-servers/manage/connect/linux-server/change-the-port-for-ssh-connections"}]},{"group":"Operating system","expanded":false,"pages":[{"title":"Install a Linux OS from a template","sidebarTitle":"Install Linux from a template","href":"/hosting/dedicated-servers/manage/operating-system/install-a-linux-os-from-a-template"}]},{"group":"Networking","expanded":false,"pages":[{"group":"Additional IP addresses","expanded":false,"pages":[{"title":"Buy an additional IP address","sidebarTitle":"Buy","href":"/hosting/dedicated-servers/manage/networking/additional-ip-addresses/buy-an-additional-ip-address"},{"title":"Configure an additional IP address","sidebarTitle":"Configure","href":"/hosting/virtual-servers/manage/networking/additional-ip-addresses/configure-an-additional-ip-address"}]},{"title":"Configure a 10 Gbps network card","sidebarTitle":"10 Gbps network card","href":"/hosting/dedicated-servers/manage/networking/configure-a-10-gbps-network-card"}]},{"title":"Set up a PTR record","sidebarTitle":"PTR record","href":"/hosting/virtual-servers/manage/set-up-a-ptr-record"},{"title":"Reboot a server","sidebarTitle":"Reboot","href":"/hosting/dedicated-servers/manage/reboot-a-server"}]},{"title":"Dedicated server statistics","sidebarTitle":"Check statistics","href":"/hosting/dedicated-servers/check-statistics-of-your-dedicated-server"},{"title":"Delete a dedicated server","sidebarTitle":"Delete","href":"/hosting/dedicated-servers/delete-a-dedicated-server"},{"group":"Troubleshooting","expanded":false,"pages":[{"title":"Server suspended for non-payment","sidebarTitle":"Suspended server","href":"/hosting/virtual-servers/troubleshooting/troubleshoot-a-server-that-was-suspended-for-non-payment"},{"title":"Server not responding to ping requests","sidebarTitle":"Server not responding to ping","href":"/hosting/dedicated-servers/troubleshooting/troubleshoot-a-server-that-is-not-responding-to-ping-requests"},{"title":"IP address is in blocklists","sidebarTitle":"IP address in blocklists","href":"/hosting/virtual-servers/troubleshooting/remove-your-ip-address-from-blacklists"},{"title":"Troubleshoot IPMI errors","sidebarTitle":"IPMI","href":"/hosting/dedicated-servers/troubleshooting/troubleshoot-ipmi-errors"},{"title":"Incorrect IP location","sidebarTitle":"Incorrect IP location","href":"/hosting/dedicated-servers/troubleshooting/troubleshoot-issues-with-an-incorrect-ip-location"},{"title":"Troubleshoot issues with SSH connection","sidebarTitle":"SSH connection","href":"/hosting/virtual-servers/troubleshooting/troubleshoot-issues-with-ssh-connection"},{"title":"Troubleshoot packet loss and high ping","sidebarTitle":"Packet loss or high ping","href":"/hosting/dedicated-servers/troubleshooting/troubleshoot-packet-loss-or-high-ping"}]}]},{"group":"Virtual servers","expanded":false,"pages":[{"title":"About Virtual Servers","sidebarTitle":"Overview","href":"/hosting/virtual-servers/about-virtual-servers"},{"group":"Before purchase","expanded":false,"pages":[{"title":"Choose a virtual server for your needs","sidebarTitle":"Choose a configuration","href":"/hosting/virtual-servers/before-purchase/choose-a-virtual-server-for-your-needs"},{"title":"Test network connectivity before buying a server","sidebarTitle":"Test network performance","href":"/hosting/virtual-servers/before-purchase/test-the-connectivity-between-your-location-and-the-server-you-want-to-buy"}]},{"title":"Order a virtual server","sidebarTitle":"Order","href":"/hosting/virtual-servers/order-a-virtual-server"},{"title":"Upgrade your virtual server","sidebarTitle":"Upgrade","href":"/hosting/virtual-servers/upgrade-your-virtual-server"},{"group":"Manage","expanded":false,"pages":[{"group":"Connect","expanded":false,"pages":[{"title":"Connect to a Windows server","sidebarTitle":"Windows server","href":"/hosting/dedicated-servers/manage/connect/connect-to-a-windows-server"},{"group":"Linux server","expanded":false,"pages":[{"title":"Connect to a Linux server via SSH","sidebarTitle":"SSH connection","href":"/hosting/virtual-servers/manage/connect/linux-server/connect-to-linux-server-via-ssh"},{"title":"Manage SSH keys","sidebarTitle":"SSH keys","href":"/hosting/virtual-servers/manage/connect/linux-server/manage-ssh-keys"},{"title":"Change the port for SSH connections","sidebarTitle":"Change SSH port","href":"/hosting/virtual-servers/manage/connect/linux-server/change-the-port-for-ssh-connections"}]},{"title":"Connect to a virtual server via VNC","sidebarTitle":"VNC","href":"/hosting/virtual-servers/manage/connect/connect-to-a-virtual-server-via-vnc"}]},{"title":"Install GUI (desktop environment) on Ubuntu, CentOS and Debian","sidebarTitle":"GUI (desktop environment)","href":"/hosting/virtual-servers/manage/install-gui-desktop-environment-on-ubuntu-centos-and-debian"},{"group":"Operating system","expanded":false,"pages":[{"title":"Order a Windows Server","sidebarTitle":"Order a Windows Server","href":"/hosting/virtual-servers/manage/operating-system/buy-a-windows-server"},{"title":"Reinstall an operating system from a template","sidebarTitle":"Reinstall from a template","href":"/hosting/virtual-servers/manage/operating-system/install-an-os-from-a-template-in-vmmanager-6"}]},{"group":"Networking","expanded":false,"pages":[{"group":"Additional IP addresses","expanded":false,"pages":[{"title":"Buy an additional IP address","sidebarTitle":"Buy","href":"/hosting/dedicated-servers/manage/networking/additional-ip-addresses/buy-an-additional-ip-address"},{"title":"Configure an additional IP address","sidebarTitle":"Configure","href":"/hosting/virtual-servers/manage/networking/additional-ip-addresses/configure-an-additional-ip-address"}]}]},{"title":"Set up a PTR record","sidebarTitle":"PTR record","href":"/hosting/virtual-servers/manage/set-up-a-ptr-record"}]},{"title":"Delete a virtual server","sidebarTitle":"Delete","href":"/hosting/virtual-servers/delete-a-virtual-server"},{"group":"Troubleshooting","expanded":false,"pages":[{"title":"Server suspended for non-payment","sidebarTitle":"Suspended server","href":"/hosting/virtual-servers/troubleshooting/troubleshoot-a-server-that-was-suspended-for-non-payment"},{"title":"Server not responding to ping requests","sidebarTitle":"Server not responding to ping","href":"/hosting/dedicated-servers/troubleshooting/troubleshoot-a-server-that-is-not-responding-to-ping-requests"},{"title":"IP address is in blocklists","sidebarTitle":"IP address in blocklists","href":"/hosting/virtual-servers/troubleshooting/remove-your-ip-address-from-blacklists"},{"title":"Troubleshoot blocked SMTP ports","sidebarTitle":"SMTP ports","href":"/hosting/virtual-servers/troubleshooting/troubleshoot-blocked-smtp-ports"},{"title":"Incorrect IP location","sidebarTitle":"Incorrect IP location","href":"/hosting/dedicated-servers/troubleshooting/troubleshoot-issues-with-an-incorrect-ip-location"},{"title":"Troubleshoot issues with SSH connection","sidebarTitle":"SSH connection","href":"/hosting/virtual-servers/troubleshooting/troubleshoot-issues-with-ssh-connection"},{"title":"Troubleshoot packet loss and high ping","sidebarTitle":"Packet loss or high ping","href":"/hosting/dedicated-servers/troubleshooting/troubleshoot-packet-loss-or-high-ping"}]}]},{"group":"Other services","expanded":false,"pages":[{"group":"DDoS protection","expanded":false,"pages":[{"title":"About Gcore DDoS protection for dedicated servers","sidebarTitle":"Overview","href":"/hosting/other-services/ddos-protection/about-gcore-ddos-protection-for-dedicated-servers"},{"title":"Activate DDoS protection for dedicated servers","sidebarTitle":"Activate","href":"/hosting/other-services/ddos-protection/activate-ddos-protection-for-your-dedicated-servers"}]},{"group":"DNS hosting","expanded":false,"pages":[{"title":"Manage DNS hosting","sidebarTitle":"Configure managed DNS","href":"/hosting/other-services/dns-hosting/manage-dns-hosting"}]},{"group":"BGP","expanded":false,"pages":[{"title":"Activate BGP","sidebarTitle":"Activate BGP","href":"/hosting/other-services/bgp/activate-bgp"}]},{"group":"Link aggreagtion","expanded":false,"pages":[{"title":"Activate Link aggregation","sidebarTitle":"Activate Link aggregation","href":"/hosting/other-services/link-aggreagtion/activate-link-aggregation"}]}]},{"group":"Account management","expanded":false,"pages":[{"title":"Set up notifications","sidebarTitle":"Notifications","href":"/hosting/account-management/set-up-notifications"},{"title":"Manage a password","sidebarTitle":"Password","href":"/hosting/account-management/manage-your-password"},{"title":"Set up two-factor authentication","sidebarTitle":"Two-factor authentication","href":"/hosting/account-management/set-up-two-factor-authentication"},{"group":"Users","expanded":false,"pages":[{"title":"Add a new user to your account","sidebarTitle":"Add a user","href":"/hosting/account-management/users/add-a-new-user-to-your-account"},{"title":"Configure user rights","sidebarTitle":"User rights","href":"/hosting/account-management/users/configure-user-rights"}]},{"title":"View the authorization history of your account","sidebarTitle":"Authorization history","href":"/hosting/account-management/view-the-authorization-history-of-your-account"}]},{"group":"Payments","expanded":false,"pages":[{"title":"Pay for Gcore services","sidebarTitle":"Pay for Gcore services","href":"/hosting/payments/pay-for-gcore-services-payment-methods"},{"title":"Renew the server","sidebarTitle":"Renew the server","href":"/hosting/payments/renew-your-server"},{"title":"Set up auto payment","sidebarTitle":"Auto payment","href":"/hosting/payments/set-up-auto-payment"},{"title":"Troubleshoot payment errors","sidebarTitle":"Troubleshoot payment errors","href":"/hosting/payments/troubleshoot-payment-errors"},{"title":"Check the payment history","sidebarTitle":"Payment history","href":"/hosting/payments/check-the-payment-history"},{"title":"Request a refund","sidebarTitle":"Refund","href":"/hosting/payments/request-a-refund"}]},{"title":"Contact our technical support","sidebarTitle":"Technical support","href":"/hosting/contact-our-technical-support"},{"title":"Manage hosting services via API","sidebarTitle":"API","href":"/hosting/manage-hosting-services-via-api"},{"title":"Become a reseller and resell our services","sidebarTitle":"Become a reseller","href":"/hosting/become-reseller-and-resell-our-services"}]},{"group":"Colocation","pages":[{"title":"Colocation","sidebarTitle":"Overview","href":"/colocation/overview"},{"title":"Connectivity","sidebarTitle":"Connectivity","href":"/colocation/connectivity"},{"title":"Power monitoring","sidebarTitle":"Power monitoring","href":"/colocation/power-monitoring"},{"title":"Service requests","sidebarTitle":"Service requests","href":"/colocation/service-requests"},{"title":"Smart Hands","sidebarTitle":"Smart Hands","href":"/colocation/smart-hands"}]},{"group":"Object Storage","pages":[{"title":"Object Storage","sidebarTitle":"Overview","href":"/storage"},{"title":"Pricing and billing","sidebarTitle":"Billing","href":"/storage/how-storage-is-billed"},{"title":"Create and manage an object or SFTP storage","sidebarTitle":"Create Object Storage","href":"/storage/create-an-s3-or-sftp-storage"},{"title":"Storage as a CDN origin","sidebarTitle":"Storage as CDN origin","href":"/storage/use-storage-as-the-origin-for-your-cdn-resource"},{"group":"Manage object storage","expanded":false,"pages":[{"title":"Manage S3 access keys","sidebarTitle":"Access keys","href":"/storage/manage-object-storage/manage-s3-access-keys"},{"title":"Managing buckets","sidebarTitle":"Manage buckets","href":"/storage/manage-object-storage/manage-buckets-via-the-control-panel"},{"title":"Protect objects from deletion with Object Lock","sidebarTitle":"Protect objects with Object Lock","href":"/storage/manage-object-storage/protect-objects-with-object-lock"},{"group":"Configure AWS CLI, S3cmd, and AWS JavaScript SDK","expanded":false,"pages":[{"title":"Connect AWS CLI, S3cmd, and AWS JavaScript SDK","sidebarTitle":"Connect external command lines","href":"/storage/manage-object-storage/configure-aws-sli-s3cmd-and-aws-javascript-sdk/connect-aws-cli-s3cmd-and-aws-sdk"},{"title":"Automatic object removal via AWS CLI","sidebarTitle":"Lifecycle policy","href":"/storage/manage-object-storage/configure-aws-sli-s3cmd-and-aws-javascript-sdk/remove-objects-from-a-bucket-automatically-with-aws-cli"},{"title":"Configure access control on S3 storage with AWS CLI and S3cmd","sidebarTitle":"Set the ACL and Policy","href":"/storage/manage-object-storage/configure-aws-sli-s3cmd-and-aws-javascript-sdk/configure-access-control-on-s3-storage-with-aws-cli-and-s3cmd"},{"title":"Generate temporary links to files with AWS CLI and S3cmd","sidebarTitle":"Generate a presigned URL","href":"/storage/manage-object-storage/configure-aws-sli-s3cmd-and-aws-javascript-sdk/generate-temporary-links-to-files-with-aws-cli-and-s3cmd"}]},{"title":"S3 service URLs and default region names","sidebarTitle":"S3 service URLs and default region names","href":"/storage/manage-object-storage/s3-service-urls-and-default-region-names"}]},{"group":"Manage SFTP storage","expanded":false,"pages":[{"title":"FileZilla connection to SFTP storage","sidebarTitle":"FileZilla","href":"/storage/manage-sftp-storage/connect-to-your-storage-with-filezilla"},{"title":"SSH key management for SFTP storage","sidebarTitle":"SSH keys","href":"/storage/manage-sftp-storage/create-and-add-an-ssh-key-to-your-storage"}]},{"title":"Request content directly from the storage","sidebarTitle":"Request files from Object Storage","href":"/storage/request-content-directly-from-the-storage"},{"title":"Check storages usage reports","sidebarTitle":"View statistics","href":"/storage/check-storages-usage-reports"},{"title":"Storage 4xx error troubleshooting","sidebarTitle":"Troubleshooting","href":"/storage/4xx-errors-how-to-solve-storage-issues"}]},{"group":"Video Streaming","pages":[{"title":"Gcore Video Streaming","sidebarTitle":"Overview","href":"/streaming"},{"title":"What's new in Video Streaming","sidebarTitle":"What's new","href":"/streaming/whats-new"},{"group":"Getting started","expanded":false,"pages":[{"title":"Start working with Gcore Streaming","sidebarTitle":"Start working","href":"/streaming/getting-started/start-work"},{"title":"Demo","sidebarTitle":"Demo","href":"/streaming/getting-started/demo"},{"title":"Isolate sub-customers and separate environments","sidebarTitle":"Sub-customers and environments","href":"/streaming/getting-started/dev_environment"}]},{"group":"AI video services","expanded":false,"pages":[{"title":"AI video services","sidebarTitle":"AI video services","href":"/streaming/video-hosting/ai-video-service"},{"group":"Content moderation","expanded":false,"pages":[{"title":"Not safe for work (NSFW) detection","sidebarTitle":"NSFW detection","href":"/streaming/ai-video-service/content-moderation/nsfw-detection"},{"title":"Hard nudity detection","sidebarTitle":"Hard nudity detection","href":"/streaming/ai-video-service/content-moderation/ai-nudity-detection"},{"title":"Soft nudity detection","sidebarTitle":"Soft nudity detection","href":"/streaming/ai-video-service/content-moderation/soft-nudity-detection"},{"title":"Sport detection","sidebarTitle":"Sport detection","href":"/streaming/ai-video-service/content-moderation/sport-detection"}]},{"group":"Generate and translate captions","expanded":false,"pages":[{"title":"Generate and translate captions","sidebarTitle":"Overview","href":"/streaming/video-hosting/ai-for-video/generate-ai-subtitles-and-add-them-to-video"},{"title":"Generate and translate AI captions","sidebarTitle":"Create AI tasks","href":"/streaming/ai-video-service/generate-ai-subtitles-and-add-them-to-video/generate-captions-in-customer-portal"}]}]},{"group":"Billing","expanded":false,"pages":[{"title":"Overview of Streaming tariffs","sidebarTitle":"Overview of tariffs","href":"/streaming/billing/overview-of-tariffs"},{"title":"Streaming usage and billing reports","sidebarTitle":"Usage reports","href":"/streaming/billing/usage-and-billing-reports"}]},{"group":"Codecs and protocols","expanded":false,"pages":[{"title":"Accepted input parameters for live streams and videos","sidebarTitle":"Input parameters","href":"/streaming/live-streams-and-videos-protocols-and-codecs/input-parameters-and-codecs"},{"title":"Transcoding output: free up to Full HD","sidebarTitle":"Output transcoding","href":"/streaming/live-streams-and-videos-protocols-and-codecs/transcoding-output"},{"title":"Premium encoding for enterprise accounts","sidebarTitle":"Premium encoding","href":"/streaming/live-streams-and-videos-protocols-and-codecs/premium-encoding"}]},{"group":"Extra features","expanded":false,"pages":[{"title":"Video streaming API tutorial","sidebarTitle":"Streaming API","href":"/streaming/api/streaming-platform-api-tutorial"},{"title":"Webhooks on system state changes","sidebarTitle":"Webhooks","href":"/streaming/extra-features/get-webhooks-from-the-streaming-platform"}]},{"group":"Interaction with CDN","expanded":false,"pages":[{"title":"Get started with CDN for video streaming","sidebarTitle":"Get started","href":"/streaming/interaction-with-cdn/get-started-streaming-cdn"},{"title":"Custom CDN resources for Video Streaming","sidebarTitle":"Custom CDN resource","href":"/streaming/interaction-with-cdn/custom-cdn-resource"},{"title":"Protect content with video secure tokens","sidebarTitle":"Video secure token","href":"/streaming/interaction-with-cdn/video-secure-token"},{"title":"Generate secure tokens for HLS/DASH","sidebarTitle":"Token generation for HLS/DASH","href":"/streaming/interaction-with-cdn/generate-hls-dash-token"},{"title":"Generate advanced secure tokens for MP4","sidebarTitle":"Advanced token for MP4","href":"/streaming/interaction-with-cdn/generate-mp4-token"},{"title":"Auto-refresh video secure tokens","sidebarTitle":"Video token auto-refresh","href":"/streaming/interaction-with-cdn/token-auto-refresh"},{"title":"Create a video token API with FastEdge","sidebarTitle":"Video token API (FastEdge)","href":"/streaming/interaction-with-cdn/token-api-fastedge"},{"title":"Add token auto-refresh to a video player","sidebarTitle":"Player token refresh","href":"/streaming/interaction-with-cdn/player-token-refresh"}]},{"group":"Live streaming","expanded":false,"pages":[{"title":"Live Streaming overview","sidebarTitle":"Overview","href":"/streaming/live-streaming/getting-started-with-live-streaming"},{"group":"Manage live streams","expanded":false,"pages":[{"title":"Create and manage a live stream","sidebarTitle":"Create live stream","href":"/streaming/live-streaming/create-a-live-stream"},{"title":"Delete or disable a live stream","sidebarTitle":"Delete live stream","href":"/streaming/live-streaming/delete-live-stream"},{"title":"Live stream screenshots","sidebarTitle":"Live screenshots","href":"/streaming/live-streaming/live-stream-screenshots"},{"title":"Live stream and restream limits","sidebarTitle":"Stream and restream limits","href":"/streaming/live-streaming/stream-and-restream-limits"},{"title":"Stream metrics","href":"/streaming/statistics/view-your-live-stream-metrics"}]},{"group":"Broadcasting software","expanded":false,"pages":[{"title":"FFmpeg","sidebarTitle":"FFmpeg","href":"/streaming/live-streaming/broadcasting-software/ffmpeg"},{"title":"GStreamer","sidebarTitle":"GStreamer","href":"/streaming/live-streaming/broadcasting-software/gstreamer"},{"title":"Larix","sidebarTitle":"Larix","href":"/streaming/live-streaming/broadcasting-software/larix"},{"title":"Open Broadcaster Software","sidebarTitle":"OBS","href":"/streaming/live-streaming/broadcasting-software/obs"}]},{"title":"Instant clips","sidebarTitle":"Clips","href":"/streaming/live-streaming/clips"},{"title":"Pause and rewind live streams","sidebarTitle":"DVR","href":"/streaming/live-streaming/pause-and-rewind-the-live-streams"},{"title":"HLS, LL-HLS, and MPEG-DASH","sidebarTitle":"HLS, LL-HLS, MPEG-DASH","href":"/streaming/live-streaming/hls-ll-hls-and-mpeg-dash"},{"title":"Combine multiple live streams","sidebarTitle":"Multicamera","href":"/streaming/live-streaming/combine-multiple-live-streams"},{"title":"Insert an overlay (HTML widgets) in your live stream","sidebarTitle":"Overlay","href":"/streaming/live-streaming/insert-html-overlays-in-live-streams"},{"title":"PTS and DTS in RTMP/SRT streams","sidebarTitle":"PTS/DTS timestamps","href":"/streaming/live-streaming/pts-dts"},{"title":"Primary, Backup, and Global Ingest Points for PUSH and PULL","sidebarTitle":"Push, pull, backup","href":"/streaming/live-streaming/primary-backup"},{"title":"Record live streams","sidebarTitle":"Record","href":"/streaming/live-streaming/record-your-live-streams-and-save-them-as-videos"},{"title":"Create and configure a restream","sidebarTitle":"Restreaming","href":"/streaming/live-streaming/create-and-configure-a-restream-to-social-media"},{"group":"RTMP, SRT, WebRTC","expanded":false,"pages":[{"title":"RTMP","sidebarTitle":"RTMP","href":"/streaming/live-streaming/protocols/rtmp"},{"title":"RTMP vs SRT: protocol comparison","sidebarTitle":"RTMP vs SRT","href":"/streaming/live-streaming/protocols/rtmp-srt"},{"title":"SRT","sidebarTitle":"SRT","href":"/streaming/live-streaming/protocols/srt"},{"title":"WebRTC WHIP to HLS/DASH","sidebarTitle":"WebRTC to HLS/DASH","href":"/streaming/live-streaming/protocols/webrtc"},{"title":"Configure low-latency ingest and playback","sidebarTitle":"Workflow for low-latency","href":"/streaming/live-streaming/configure-low-latency-playback"}]},{"title":"Subtitles and captions in live streams","sidebarTitle":"Subtitles and captions","href":"/streaming/live-streaming/subtitles-and-captions"}]},{"group":"Q\u0026A and Use cases","expanded":false,"pages":[{"title":"Streaming FAQs","sidebarTitle":"FAQ","href":"/streaming/faq/streaming-faq"},{"title":"Configure hot-swapping with AWS Elemental Live and Nimble Streamer","sidebarTitle":"Hot-swapping with Elemental","href":"/streaming/faq/case-study-hot-swapping-elemental"},{"title":"Video streaming HTTP status codes","sidebarTitle":"HTTP status codes","href":"/streaming/faq/http-status-codes"},{"title":"Live Streaming issues","sidebarTitle":"Live Streaming issues","href":"/streaming/faq/live-streaming-issues"},{"title":"Solution: Live broadcaster","sidebarTitle":"Solution: Live broadcaster","href":"/streaming/faq/solution-live-broadcaster"},{"title":"Solution: Live web","sidebarTitle":"Solution: Live web","href":"/streaming/faq/solution-live-web"},{"title":"Solution: Video app","sidebarTitle":"Solution: Video app","href":"/streaming/faq/solution-video-app"},{"title":"VOD issues","sidebarTitle":"VOD issues","href":"/streaming/faq/vod-issues"},{"group":"WebRTC issues","expanded":false,"pages":[{"title":"Fix the camera or microphone if they do not work","sidebarTitle":"Camera and microphone","href":"/streaming/faq/real-time-video-issues/fix-the-camera-or-microphone-if-they-do-not-work"},{"title":"Audio quality is reduced when using Bluetooth headsets in video call apps","sidebarTitle":"Bad audio while Bluetooth mic","href":"/streaming/faq/real-time-video-issues/audio-quality-is-reduced-when-using-bluetooth-headsets-in-video-call-apps"}]}]},{"group":"Player","expanded":false,"pages":[{"title":"Built-in web player","sidebarTitle":"Built-in player","href":"/streaming/player/customize-appearance-of-the-built-in-player"},{"title":"JS Video Player \u0026 SDK","sidebarTitle":"JS player \u0026 SDK","href":"/streaming/player/player-api-tutorial"}]},{"group":"Statistics","expanded":false,"pages":[{"title":"Video player metrics","href":"/streaming/statistics/statistics-of-built-in-player"},{"title":"Video views and delivered minutes","href":"/streaming/statistics/statistics-of-views"},{"title":"View statistics of live streams and videos","sidebarTitle":"View statistics","href":"/streaming/statistics/view-statistics-of-live-streams-videos-and-billing"}]},{"group":"Video hosting","expanded":false,"pages":[{"title":"Getting started with video hosting","sidebarTitle":"Getting started VOD","href":"/streaming/video-hosting/getting-started-with-video-hosting"},{"group":"Manage library","expanded":false,"pages":[{"title":"Upload and manage videos","sidebarTitle":"Upload and manage","href":"/streaming/video-hosting/upload-a-video-and-embed-it-to-your-app"},{"title":"Organize uploaded videos","sidebarTitle":"Directories and tags","href":"/streaming/video-hosting/organize-uploaded-videos"},{"title":"Delete uploaded videos","sidebarTitle":"Delete videos","href":"/streaming/video-hosting/delete-videos"},{"title":"Download files","href":"/streaming/video-hosting/original-files"}]},{"title":"Protect videos with AES-128 encryption","sidebarTitle":"AES-128","href":"/streaming/video-hosting/protect-your-videos-with-the-aes-128-encryption"},{"title":"HEVC, AV1, and VP9 multi-codec VOD","sidebarTitle":"HEVC, AV1, VP9","href":"/streaming/video-hosting/multi-codec"},{"title":"HLS, MPEG-DASH, and MP4","sidebarTitle":"HLS, MPEG-DASH, MP4","href":"/streaming/video-hosting/hls-and-mp4"},{"title":"Download and deliver MP4 files","sidebarTitle":"Download MP4 files","href":"/streaming/video-hosting/download-mp4-files"},{"title":"Create an illusion of a live broadcast with uploaded videos","sidebarTitle":"Live imitation","href":"/streaming/video-hosting/create-an-illusion-of-a-live-broadcast-with-uploaded-videos"},{"title":"Videos with multiple audio tracks","sidebarTitle":"Multi audio","href":"/streaming/video-hosting/multi-audio"},{"title":"Create and configure playlists for videos","sidebarTitle":"Playlists","href":"/streaming/video-hosting/create-and-configure-playlists-for-videos"},{"title":"Video Lifecycle and Statuses","sidebarTitle":"Status VOD","href":"/streaming/video-hosting/vod-status"},{"title":"Subtitles and closed captions for VOD","sidebarTitle":"Subtitles \u0026 Captioning","href":"/streaming/video-hosting/subtitles-and-closed-captions-for-vod"},{"title":"Timeline hover previews: use with players and Roku devices","sidebarTitle":"Timeline previews","href":"/streaming/video-hosting/timeline-hover-previews-use-in-players-and-roku-devices"},{"title":"Upload and migrate via API","sidebarTitle":"Upload and migrate via API","href":"/streaming/video-hosting/upload-video-via-api"}]}]},{"group":"DDoS protection","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/ddos-protection"},{"title":"How DDoS Protection works","sidebarTitle":"How protection works","href":"/ddos-protection/about-ddos-protection"},{"group":"Setting up the service","expanded":false,"pages":[{"title":"Service activation","sidebarTitle":"Service activation","href":"/ddos-protection/onboarding-service/service-activation"},{"title":"Plan activation","href":"/ddos-protection/onboarding-service/plan-activation"},{"title":"Network submission","href":"/ddos-protection/onboarding-service/network-submission"},{"title":"Review and approval","href":"/ddos-protection/onboarding-service/review-and-approval"},{"title":"Network configuration","href":"/ddos-protection/onboarding-service/network-configuration"},{"title":"Custom protection profile configuration","href":"/ddos-protection/onboarding-service/custom-protection-profile-configuration"},{"title":"Apply a custom profile to a protected network","href":"/ddos-protection/onboarding-service/apply-a-custom-profile-to-a-protected-network"},{"title":"Set a GRE tunnel with Gcore","sidebarTitle":"Set a GRE tunnel","href":"/ddos-protection/onboarding-service/gre-tunneling/set-a-gre-tunnel-with-gcore"},{"title":"Troubleshooting","href":"/ddos-protection/onboarding-service/troubleshooting"}]},{"title":"Traffic Analytics","sidebarTitle":"Traffic Analytics","href":"/ddos-protection/traffic-analytics"},{"title":"DDoS log and monitoring","href":"/ddos-protection/events-log"}]},{"group":"Edge Proxy","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/edge-proxy/overview"},{"title":"How Edge Proxy protection works","sidebarTitle":"How protection works","href":"/edge-proxy/how-protection-works"},{"title":"Setup and configuration","sidebarTitle":"Setup and configuration","href":"/edge-proxy/setup-and-configuration"},{"title":"Supported applications","sidebarTitle":"Supported applications","href":"/edge-proxy/supported-applications"},{"title":"Manage Edge Proxy","sidebarTitle":"Manage Edge Proxy","href":"/edge-proxy/manage-edge-proxy"},{"title":"FAQs and troubleshooting","sidebarTitle":"FAQs and troubleshooting","href":"/edge-proxy/faqs-and-troubleshooting"}]},{"group":"WAAP","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/waap/overview"},{"group":"Getting started","expanded":false,"pages":[{"title":"Configure WAAP for a new domain","sidebarTitle":"Configure WAAP for a new domain","href":"/waap/getting-started/configure-waap-for-a-domain"},{"title":"WAAP-protected domain management","sidebarTitle":"WAAP-protected domain management","href":"/waap/getting-started/manage-domains"},{"title":"Billing","sidebarTitle":"Billing","href":"/waap/getting-started/billing"}]},{"group":"Analytics","expanded":false,"pages":[{"title":"WAAP Analytics","sidebarTitle":"WAAP Analytics","href":"/waap/analytics/waap-analytics"},{"title":"Dashboard","sidebarTitle":"Dashboard","href":"/waap/analytics/dashboard"},{"title":"Events","sidebarTitle":"Events","href":"/waap/analytics/events"},{"title":"Domains","sidebarTitle":"Domains","href":"/waap/analytics/domains"},{"title":"View WAAP statistics in Grafana","sidebarTitle":"Grafana reports","href":"/waap/analytics/view-waap-statistics-in-grafana"}]},{"group":"Firewall","expanded":false,"pages":[{"title":"Access control","sidebarTitle":"Access control","href":"/waap/firewall/access-control"},{"title":"IP allowlist and blocklist","sidebarTitle":"IP allowlist and blocklist","href":"/waap/firewall/ip-allowlist-and-blocklist"},{"title":"IP Reputation","sidebarTitle":"IP Reputation","href":"/waap/firewall/ip-reputation"},{"title":"Check IP","sidebarTitle":"Check IP","href":"/waap/firewall/check-ip"}]},{"title":"L7 DDoS protection","sidebarTitle":"L7 DDoS protection","href":"/waap/ddos-protection"},{"group":"Default Rules","expanded":false,"pages":[{"title":"WAAP policies","sidebarTitle":"WAAP policies","href":"/waap/waap-policies"},{"title":"OWASP threats","sidebarTitle":"OWASP threats","href":"/waap/waap-policies/waf-and-owasp-top-threats"},{"title":"Behavioral WAF","sidebarTitle":"Behavioral WAF","href":"/waap/waap-policies/behavioral-waf"},{"title":"CMS protection","sidebarTitle":"CMS protection","href":"/waap/waap-policies/cms-protection"}]},{"group":"Custom Rules","expanded":false,"pages":[{"title":"WAAP rules","sidebarTitle":"WAAP rules","href":"/waap/waap-rules"},{"title":"Custom Rules","sidebarTitle":"Custom Rules","href":"/waap/waap-rules/custom-rules"},{"title":"Policy overrides","sidebarTitle":"Policy overrides","href":"/waap/waap-rules/policy-overrides"},{"title":"Advanced rate-limiting rules","sidebarTitle":"Rate limiting","href":"/waap/waap-rules/advanced-rules/advanced-rate-limiting-rules"},{"group":"Advanced rules","expanded":false,"pages":[{"sidebarTitle":"Advanced Rules","title":"Advanced Rules","href":"/waap/waap-rules/advanced-rules"},{"title":"Advanced rule objects and attributes","sidebarTitle":"Advanced rule objects and attributes","href":"/waap/waap-rules/advanced-rules/advanced-rule-objects"},{"title":"Source field objects in advanced rule expressions","sidebarTitle":"Source field objects","href":"/waap/waap-rules/advanced-rules/source-field-objects"}]},{"group":"Tag rules","expanded":false,"pages":[{"title":"Tag rules","sidebarTitle":"Tag rules","href":"/waap/waap-rules/custom-rules/tag-rules"},{"title":"Reserved tags","sidebarTitle":"Reserved tags","href":"/waap/waap-rules/custom-rules/tag-rules/reserved-tags"},{"title":"Predefined tags and their descriptions","sidebarTitle":"Predefined tags","href":"/waap/waap-rules/custom-rules/tag-rules/predefined-tags"}]}]},{"group":"Bot Management","expanded":false,"pages":[{"title":"Bot Protection","sidebarTitle":"Bot Protection","href":"/waap/troubleshooting/enable-troubleshoot-bot-protection"},{"title":"Known Bots","sidebarTitle":"Known Bots","href":"/waap/waap-policies/known-bots"},{"title":"Anti-automation and bot protection","sidebarTitle":"Anti-automation and bot protection","href":"/waap/waap-policies/anti-automation-and-bot-protection"},{"title":"Invalid user agent and Unknown user agent","sidebarTitle":"Invalid user agent and Unknown user agent","href":"/waap/waap-policies/invalid-user-agent-and-unknown-user-agent"}]},{"group":"Threat Intelligence","expanded":false,"pages":[{"group":"Security Insights","expanded":false,"pages":[{"title":"Security Insights","sidebarTitle":"Overview","href":"/waap/threat-intelligence/security-insights/security-insights"},{"title":"View and investigate insights","sidebarTitle":"View and investigate insights","href":"/waap/threat-intelligence/security-insights/view-insights"},{"title":"Manage insight status","sidebarTitle":"Manage insight status","href":"/waap/threat-intelligence/security-insights/manage-insights"},{"title":"Manage Silence Rules","sidebarTitle":"Manage Silence Rules","href":"/waap/threat-intelligence/security-insights/manage-silence-rules"}]},{"title":"TLS fingerprinting with JA3 and JA4","sidebarTitle":"TLS fingerprinting","href":"/waap/threat-intelligence/tls-fingerprinting"},{"title":"IP Spotlight","href":"/waap/ip-security/ip-spotlight"}]},{"group":"API Protection","expanded":false,"pages":[{"title":"API discovery and protection","sidebarTitle":"API discovery and protection","href":"/waap/api-discovery-and-protection"},{"title":"API discovery","sidebarTitle":"API discovery","href":"/waap/api-discovery-and-protection/api-discovery"},{"title":"Configure API Protection policies using reserved tags","sidebarTitle":"Configure API Protection using reserved tags","href":"/waap/api-discovery-and-protection/configure-api-access-with-reserved-tags"},{"title":"Manually add endpoints to the API base path","sidebarTitle":"Manually add endpoints to API base path","href":"/waap/api-discovery-and-protection/configure-api-base-path"},{"title":"Advanced API protection","sidebarTitle":"Advanced API protection","href":"/waap/waap-policies/advanced-api-protection"},{"title":"Protocol validation","sidebarTitle":"Protocol validation","href":"/waap/waap-policies/protocol-validation"}]},{"group":"Response pages","expanded":false,"pages":[{"title":"Response pages","sidebarTitle":"Response pages","href":"/waap/response-pages"},{"title":"Create custom response pages","sidebarTitle":"Create custom response pages","href":"/waap/response-pages/create-custom-response-pages"},{"title":"Manage custom response pages","sidebarTitle":"Manage custom response pages","href":"/waap/response-pages/manage-custom-response-pages"}]},{"group":"Terraform","expanded":false,"pages":[{"title":"Manage WAAP via Terraform v0","sidebarTitle":"Manage via Terraform v0","href":"/waap/manage-waap-via-terraform"}]},{"group":"FAQs","expanded":false,"pages":[{"title":"How does WAAP JavaScript injection work?","sidebarTitle":"How does WAAP JavaScript injection work?","href":"/waap/frequently-asked-questions/javascript-injection"},{"title":"What cookies and local storage does WAAP use?","href":"/waap/frequently-asked-questions/waap-cookies"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/waap/troubleshooting"},{"title":"Troubleshoot blocked users","sidebarTitle":"Troubleshoot blocked users","href":"/waap/troubleshooting/troubleshoot-blocked-users"},{"title":"Troubleshoot 5xx errors","sidebarTitle":"Troubleshoot 5xx errors","href":"/waap/troubleshooting/troubleshoot-5xx-errors"}]}]}]},{"tab":"Reseller Documentation","pages":[{"title":"Reseller Documentation","href":"/reseller-support"}]},{"tab":"Developer Tools","pages":[{"title":"Developer Tools","href":"/developer-tools"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"basePath":"","title":"Crop images - Gcore Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}