
Visual Editing by DatoCMS is a feature of the DatoCMS headless CMS that transforms how content editors interact with websites. Instead of navigating complex admin panels, editors can click directly on any visible element on the page to edit its content in the CMS. This tool is built for both developers who want to streamline editing workflows and content editors who think in pages and posts rather than database fields. The core value is eliminating the friction of locating and updating content through traditional record forms, making real-time website editing as intuitive as point-and-click.
Content editors constantly face the problem of hunting through nested record forms, modular blocks, and field groups to find the right piece of text or image to update. For example, a headline that lives inside a specific modular block might require opening multiple tabs and scrolling through records to locate the correct field. This pain point slows down publishing, increases errors, and frustrates non-technical team members who need to make quick edits. Visual Editing directly addresses this by letting editors click on the live page element, instantly opening the corresponding CMS field for editing without any hunting.
The first major feature group is Click-to-edit via Content Link. Editors visit the website in draft mode, hover over any piece of content, and see what is editable. Clicking on the element opens DatoCMS in a new tab with the exact field pre-selected. This works entirely on the frontend and supports any hosting provider including Vercel, Netlify, and Cloudflare. The technology behind it uses steganography: invisible Unicode characters appended to every string in GraphQL API responses encode the origin (record ID, field path, locale), so the frontend automatically knows where each value comes from without manual wiring.
The second major feature group is Visual Mode side-by-side editing in the CMS, powered by the Web Previews plugin. This workflow provides a preview on the left side of the screen and an edit panel on the right. Editors can click any piece of content in the preview, and the edit panel opens right there — no tab switching, no context loss. The plugin also supports bidirectional navigation (scrolling either panel keeps the other synchronized) and a full-screen Visual Editing mode. This upgrade to the existing Web Previews plugin requires minimal configuration to enable side-by-side editing for editors.
admin
The third feature group includes dedicated SDKs and integration guides for popular frameworks. DatoCMS provides SDKs for React/Next.js, Astro, Svelte/SvelteKit, and Vue/Nuxt, each with its own <ContentLink /> component that handles detection, overlay rendering, and keyboard shortcuts. Additionally, a framework-agnostic library called @datocms/content-link is available for projects using other frameworks. Starter kits come pre-configured with Draft Mode, Real-time Updates, Content Link, and Web Previews already wired together, allowing developers to get started immediately.
To enable Visual Editing, developers add two headers to existing GraphQL requests when fetching draft content: X-Visual-Editing: v1 and X-Base-Editing-Url with the project’s admin URL. Then they add the <ContentLink /> component to the layout, which automatically scans for embedded metadata and renders edit overlays on the appropriate DOM nodes. Optionally, installing and configuring the Web Previews plugin unlocks side-by-side editing. The setup works with the entire content model out of the box, including links to records, blocks, Structured Text, and modular content. Some complex field types may require additional data attributes to help Content Link distinguish between editable regions, but this is minimal work.
Concrete use cases include an editor changing a headline on a landing page by simply clicking it and updating the text in the CMS, with changes appearing instantly. For localized content, editors can click on a translated element and edit in the correct locale without navigating through language tabs. Developers building new pages with modular blocks can use side-by-side mode to rearrange components and preview results in real time. Enterprise environments managing 250+ editors, as seen in the Polestar case study, benefit from reduced support requests and faster updates. The outcome is a seamless editing experience that merges design and content management.
Visual Editing is available on every DatoCMS plan, including the Free tier, with no upgrade or feature gate. It is designed for web developers using React/Next.js, Astro, Svelte, SvelteKit, Vue, or Nuxt who want to implement a WYSIWYG editing experience with minimal code. Content editors and digital marketers who need to make frequent website updates without technical assistance are the primary end users. The integration works with any hosting provider and leverages the existing DatoCMS infrastructure. Overall, Visual Editing transforms the headless CMS editing experience by eliminating context switching and making content management as straightforward as clicking on the page.
Web developers using headless CMS frameworks like Next.js, Astro, Svelte, or Vue who want to implement visual editing with minimal code. Content editors and digital marketers who need to make frequent website updates without technical assistance. Enterprise teams managing large-scale sites with multiple editors requiring efficient workflows. Agencies building client websites that need intuitive editing interfaces for non-technical users.