User Guide

This user guide covers the core concepts of Automad's essential features, content editing, and page creation. To begin, visit /dashboard on your site and sign in with your credentials, then follow the pages sequentially to understand what you can accomplish and how.

The Dashboard

The dashboard is the central administration area of an Automad site. It provides everything you need to manage content and pages, adjust site-wide settings, invite other users to collaborate, and install or update themes to shape the look and behavior of your site.

Previews & In-Page Editing

While you are signed in, your site always shows the latest unpublished changes. In the dashboard, you can also preview a page including its unpublished changes by clicking the little eye icon in the menu at the top of the page editor, next to the tabs. Navigation is disabled inside the preview.

When browsing your site while signed in, a floating dock at the bottom of the page lets you switch into the In-Page edit mode using the Enable Editing toggle. Editable areas are then highlighted. Click the Edit button on any highlighted area to make changes directly on the page, and use Disable Editing to leave the edit mode again.

The dock also provides quick access to the dashboard and the current page's settings, content, customizations, and files, and lets you publish page drafts instantly. You can drag the dock by its handle to move it out of the way. It keeps its position across pages, and a double-click on the handle moves it back to its original place.

What's Next in This Guide

You're ready to explore deeper! The following pages will walk you through the key concepts that make Automad powerful.

Publishing
In Automad, changes made to content fields — such as blocks or settings — are saved automatically. These changes are stored as drafts. Signed-in users can see and edit drafts at any time, while public visitors only see content that has been published. This makes it easy to work on content over a longer period without exposing unfinished pages to your visitors.
Pages
Pages are the building blocks of every Automad site. They are organized in a tree that defines the structure and the URLs of your site. This guide explains how to add pages, configure their settings, move them around and restore them after deleting.
Global Defaults
One of Automad’s core ideas is the concept of global defaults. Many fields can be set either globally or individually for each page. When a page is displayed, Automad first checks the page itself for a value. If nothing is set there, it falls back to the global data.
Blocks
Blocks are small, self-contained pieces of content such as text paragraphs, headings, galleries, slideshows, and more. You can also add dynamic content like Pagelists, Filelists, or custom snippets. The block editor offers an intuitive editing experience and lets users freely compose a page from multiple blocks.
Layouts
Layouts in Automad are created using the Layout Section block. They can be added anywhere on a page and can contain other Layout Sections, allowing you to create complex, nested designs. Sections can also be set to stretch to the full width of the content area or page. Watch the short videos on this page to see these features in action.
Components
Components in Automad are reusable groups of blocks that let you create consistent sections across your site without having to rebuild them each time. They are ideal for content that appears on multiple pages, such as call-to-action cards, card grids, address blocks, or repeated project and product cards. Since a component is edited in one central place, every change automatically shows up wherever the component is used.
Images
Images play an essential role on the web and in any digital presence. Automad provides responsive images, image galleries, and slideshows as blocks that can be added to any block editor field. These blocks make it easy to display individual images with custom focal points and responsive aspect ratios, as well as manage and present image collections in versatile ways — from structured galleries to responsive slideshows.
Files
Every page can have its own files, such as images, documents or downloads. Files that are used across the whole site, such as a logo or favicons, belong to Global Data and Files instead. Both places offer the same tools for uploading and managing files.
Pagelists & Tags
A pagelist is essentially a curated selection of pages that are rendered using a shared template. Each page in the selection is iterated and displayed in a consistent way, which makes pagelists suitable for many common use cases. They can power a simple navigation, but they work just as well for more visual layouts, such as a portfolio grid or blog where each entry shows a preview, title, or other page-specific information.
Open Graph & Favicons
Automad takes care of most metadata and icon-related details automatically, so pages are ready for browsers, devices, and social platforms right from the start. Without any configuration, sensible defaults are generated for things like page titles, descriptions, icons, and social previews. At the same time, Automad keeps everything transparent and flexible, making it easy to customize or override individual parts whenever more control is needed.
Multilingual Sites
In case your visitors are spread across different countries and you need to provide your content in several languages, Automad's built-in language routing lets you serve each visitor the content that matches their language. Follow the steps on this page to turn your site into a multilingual website.
Scripts & Integrations
Automad allows you to inject custom HTML markup and JavaScript code into your site either globally or on individual pages. This capability enables seamless integration with third-party services such as analytics platforms and commenting systems.
Custom Styles
Customize your site's appearance by adding custom CSS at the global level or on individual pages. Custom CSS fields are located in Global Data and Files → Customizations, as well as in the Customizations section of each page.
Cookie Banners
Automad automatically displays a cookie consent banner when a page includes content from an embed block, such as YouTube videos, SoundCloud tracks or social media posts. The embedded content is only loaded after the visitor has accepted the use of third-party cookies. This helps you comply with the GDPR.
Search & Navigation
The dashboard offers several ways to find content and move around quickly, from a sitewide search and replace to keyboard shortcuts.
Page Versioning
Automad automatically maintains a page history by creating snapshots of your page settings and text content whenever you save changes. To preview and restore a previous version, open the More dropdown menu in the top right of the page settings and select Restore a previous version.
Getting Started Publishing