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.
Depending on the template, a page can provide one or several block editors for different sections. Block editors also support embedded content from services like YouTube or Vimeo simply by pasting a URL.
Adding Blocks
Start by clicking anywhere in the block editor to add your first block. Hit Enter ⏎ to add more blocks wherever you like. Then pick a block type by clicking the + icon or by typing / into an empty block — mix and match to build your page your way. The + icon and the block handle ⋮⋮ appear to the left of a block when you hover over it. Click the handle to open the block settings.
Moving Blocks Around
You can rearrange blocks by dragging the handle ⋮⋮ to the left of a block and dropping the block wherever you like.
Block Settings
Clicking the handle ⋮⋮ of a block opens its settings. Besides options that are specific to a block type, every block has the universal settings spacing, ID and CSS class, which are described below. The settings menu also lets you Duplicate a block. Inside a Layout Section, it additionally offers the width of a block, and blocks that support it can be stretched to the full width using Stretch block.
Spacing
The Padding settings let you add space around a block individually for each side using the Spacing Top, Spacing Right, Spacing Bottom and Spacing Left fields. Each value consists of a number and a unit such as px, %, rem, em, vh or vw. The spacing is applied as padding to the block, so it adds to the default spacing of the theme. Leave a field empty to keep the default.
ID
The ID is added as id attribute to the block. It can be used as target for links to a specific block on a page, for example /about#contact, or as selector in custom styles. IDs must be unique on a page. In case the same ID is used more than once, a number is appended to the following ones, such as contact-1.
CSS Class
The CSS Class field adds one or more classes, separated by spaces, to the block. In contrast to an ID, a class can be shared by any number of blocks. That makes it the right choice for styling several blocks the same way with custom styles.
Formatting Text
When you select text inside a block, an inline toolbar offers the following formatting options:
- Bold, Italic, Underline, Strike through and Inline code
- Link, optionally opened in a new tab
- Color for the text and its background
- Font Size and Line height
- Text alignment: left, center or right
- Math for inline TeX formulas
Block Types
Below is a list of all available blocks, along with an overview of the supported embed services. You can mix and match these blocks to create your content, and easily embed media from popular services where supported.
| Text | This is the default block and contains basic text. |
| Heading | Heading levels 1–6. |
| Layout Section | Layout sections can be used to create complex layouts. They can contain any other type of block, can be nested and styled. A section can also be used to create a typical card. |
| Collapsible Section | Collapsible sections can be used to create accordion elements, like typical FAQ sections. Like Layout Sections, they can contain one or more blocks of any type. |
| Component | Components are reusable groups of blocks. Edit them once in a central place and they’ll update everywhere on your site. |
| List | A list of items, either ordered or unordered. Lists can also be nested. |
| Table | A table builder with flexible amounts of rows and columns. |
| Callout Box | A callout box is used to highlight and emphasize specific parts of your content. |
| Blockquote | A quote with a caption for the author or source. |
| Delimiter | A horizontal line that can be used as a delimiter between blocks. |
| Image | A single image with an optional caption and Alt Text. Images can also link to other pages or URLs, optionally opened in a new tab. |
| Video | A single video with an optional caption. Autoplay, looping, muting and the video controls can be set in the block settings. |
| Image Gallery | A gallery for combining multiple images into flexible, responsive masonry, row, or grid layouts, with a built-in lightbox. |
| Image Slideshow | A slideshow that combines multiple images into a responsive carousel. |
| Buttons | A set of up to two customizable buttons to create call-to-action links. |
| Table of Contents | A simple, nested table of contents including headings of levels 2-4. |
| Source Code | A block to display source code snippets including syntax highlighting, language selection and optional line numbers. |
| Math / TeX | The Math block is based on KaTeX and can render mathematical formulas as well as other TeX-compatible content. |
| HTML / Markdown | A block for raw Markdown or HTML markup. |
| Mail Form | A customizable email form that can be used on contact pages. Sending emails requires the Mail settings in the System Settings to be configured. |
| Pagelist | A block that uses templates to render a selection of pages, making it ideal for building navigations, portfolio pages, or blogs. |
| Filelist | Similar to a Pagelist, a Filelist renders a selection of files using a template. The files are selected by a File pattern such as *.pdf, which makes it useful for download lists. |
| Snippet | A block that renders snippets of Automad's template language inside the block editor. |
Embedding Content
Automad supports embedding content from a variety of popular platforms and services. Embeds have no entry in the block menu. Instead, paste a URL from one of the supported platforms into an empty block and the content is embedded automatically. URLs of other services stay plain text. The following platforms are currently supported for embedding: