Search

Choose between the seven resize strategies auto scales to fit inside a box; fit fills it and crops (despite the name); crop cuts a region unscaled; exact and square stretch; landscape derives the height; for a portrait result, use auto with only a height. Decide from what the slot must guarantee. /how-to/choose-a-resize-strategy Authenticate a server-to-server integration with an API key For an integration that uses an API key, the older option: the server calls the API with Authorization: Bearer and a key belonging to a backend user made for the integration. Choose that user's permissions carefully, limit the key by IP address, keep it in one module, and read the 403's message when it fails. A new integration uses OAuth instead. /how-to/server-to-server-api-key Resize an image from JavaScript using URL parameters Every template transformation is also a query parameter on the image URL: w, h, s, f, q. Hand the script a base path from the template, round to a few fixed widths, and never put visitor input into the parameters. /how-to/resize-from-javascript Connect an editor to a site's MCP server One configuration entry, a name and https://<site>/cdna-mcp, connects an AI assistant to a site; the client handles the OAuth sign-in. Put the development site in the repository's .mcp.json and production only in your own configuration. /how-to/connect-an-editor-to-mcp Roll back a page to an earlier revision Every save keeps the revision before it. Find the one that was right and send its id as activeRevision on the page: it is live again at once, with no new revision. Then base the next edit on it with originRevision, or the edit brings back what you rolled back. /how-to/roll-back-a-revision Add, reorder or remove a section on many pages Adding a section is safe with an append or an insert, one patch per page. Reordering and removing are not, once a page's positions have drifted: read the collection, change the list in your code, and write it back whole with areaContent, which also renumbers it. /how-to/sections-on-many-pages Set and clear a custom URL through the API customUrl takes an object with url. Set it in a request after the record exists, start the path with a slash, clear it with an empty url rather than null, and expect a 422 when another record already holds the address. /how-to/custom-url-through-the-api Chaining one job to another /books/hooks/what-starts-a-hook/chaining Guarding against recursion /books/hooks/what-starts-a-hook/recursion Handover /books/performance-and-deployment/after-launch/handover Interface strings /books/template-languages/translation/interface-strings Translating in Smarty /books/template-languages/translation/translating-in-smarty Record actions /books/hooks/what-a-hook-does/actions Render template and send email /books/hooks/what-a-hook-does/render-template-and-email Shaping the response with properties /books/apis/rest/properties Files, PDFs and certificates /books/hooks/what-a-hook-does/files-and-certificates Stopping a job early /books/hooks/what-a-hook-does/stop Why a page shows 404 /books/user-documentation/getting-started/why-a-page-shows-404 What is in a theme repository /books/theme-repo/anatomy-of-a-theme-repo/anatomy AI agent actions /books/hooks/what-a-hook-does/agent-actions Sign in to Core dna /books/user-documentation/getting-started/sign-in-to-core-dna A relation as an id or an object /books/apis/rest/relations Repository shapes you will inherit /books/theme-repo/anatomy-of-a-theme-repo/repo-shapes Confirming a request did what you asked /books/apis/rest/silent-failures Source and build output /books/theme-repo/anatomy-of-a-theme-repo/source-and-output The generated documentation /books/apis/rest/generated-documentation Conditions: if, else if and else /books/hooks/flow/control-flow Webpack and gulp builds /books/theme-repo/anatomy-of-a-theme-repo/builds-and-bundles Loops and failing iterations /books/hooks/flow/loops Bundle boundaries /books/theme-repo/anatomy-of-a-theme-repo/bundle-boundaries Idempotency and replay /books/hooks/flow/idempotency Versioned content and the live revision /books/apis/writing-content/versioned-content The CSP nonce /books/theme-repo/anatomy-of-a-theme-repo/assets-csp-and-the-build-pipeline Cache-busting asset URLs /books/theme-repo/anatomy-of-a-theme-repo/cache-busting Making a revision live, rolling back and publishing /books/apis/writing-content/going-live Translation files in the theme repo /books/theme-repo/anatomy-of-a-theme-repo/translations What must never be committed /books/theme-repo/anatomy-of-a-theme-repo/never-commit Deliverability, tracking and safe testing /books/hooks/sending-email/deliverability-and-testing Custom fields /books/apis/writing-content/custom-fields What the controller hands the template /books/theme-repo/rendering/rendering-a-record How the navigation menu is built /books/user-documentation/navigation-and-menus/how-the-navigation-menu-is-built Finding out a scheduled job stopped /books/hooks/scheduling/monitoring The GraphQL API /books/apis/graphql-api/graphql Escaping output /books/theme-repo/rendering/escaping Documenting a template's inputs /books/theme-repo/rendering/documenting-inputs Retry, backoff and dead letters /books/hooks/integrations/retries-and-dead-letters Securing a custom endpoint /books/apis/endpoints/securing-endpoints Several stylesheets from one build /books/theme-repo/stylesheets/several-stylesheets Authentication and authorisation /books/apis/auth/authentication Design tokens as custom properties /books/theme-repo/stylesheets/design-tokens