Skip to content

Blocks and regions

A region is a named area of the page that the theme provides: the header, the sidebar, the footer. A block is something placed in a region: your own text, a menu, a View, or a system block such as the search form or the logo. Which blocks go where is the block layout, set in the admin under Structure → Blocks (/admin/config/blocks).

The Blocks page: the active theme’s tab, the form to add a block, its system, View and menu blocks, and the Header region with the main navigation

The theme declares its regions; the admin can’t add or remove them. The bundled themes have the same ones (some under labels of their own):

Region Machine name Where
Header header the top of every page; the main menu lives here
Sidebar sidebar the side column, shown only when it has blocks for the page
Content top content_top between the page’s title and its content
Content bottom content_bottom after the content
Inside content (content page) content_inline inside a content item’s page
Footer footer the footer
Footer bottom line footer_bottom the footer’s last line; the copyright block on a new site

Another theme may have other regions. Every theme also has Hidden (disabled): a block moved there is kept with its settings but isn’t shown anywhere.

To see where the regions are, press Region demo mode on the Blocks page. It opens the front page with each region framed and labeled with its machine name, empty ones marked “(empty)”. Blocks shown only on some pages appear when you open such a page with ?blocks_demo=1 added to its address (for administrators only); the demo page has a box that opens a path this way.

Type Add it with What it is
Custom block Add block your text, edited in the rich text editor
System block Add system block rendered by the engine or a module; only its region, title, settings and visibility can be changed
View block Add View block a View’s Block display (Views)
Menu block Add menu block one of the site’s menus

System blocks of the engine:

Block Shows Settings
Logo the logo set on Site information, else the theme’s; a link to the front page; without either, nothing -
Search the site the search form (Search) -
User menu sign in / the signed-in user’s links -
Recent comments the latest 10 comments, each a link to it, and a link to all of them (/comments/recent) -
Tag cloud the most used terms, bigger for more content (Taxonomy) Vocabulary, Number of terms, Size levels
Copyright © <year> <holder> Copyright holder (empty - the site’s name), First year (0 - the current year only)

Modules add their own while they are enabled, for example Form, Poll, Language switcher or Error report hint. A block that shows one thing (a form, a poll) asks on its page what it Shows; until you choose, it shows nothing. A disabled module’s blocks aren’t shown.

Custom block.

  1. Under Add block enter a Name and press Add. The block goes to the end of the theme’s default region (the Sidebar in the bundled themes), published, visible to everyone, with Show title on - it is on the site at once, so fill it in next.
  2. Open it (the pencil icon) and fill in:
Field What it does
Name identifies the block in the admin
Machine name what a text or a template embeds the block by: [[block:<machine name>]] (Embeds). Made from the name (_2, _3… when taken); can be changed - lowercase Latin letters, digits and _, starting with a letter, not another block’s
Show title shows the name as a heading above the block
Text format how the text is cleaned on save. The default (- as before (plain HTML) -) keeps safe HTML only; a format allowing script or style (/admin/config/text-formats) is the only way to keep raw code, such as an ad snippet. A chosen format’s processing when shown (Embeds, say) works on the block’s text too
Content the block’s text
Published an unpublished block is kept but not shown
Load on scroll see below
Roles, Visibility see Visibility

System, View and menu blocks. Choose the block, View or menu and the region in its form and press Add. The View and menu forms also take a first visibility choice, and the menu form the levels to show. The rest is on the block’s page (the pencil icon).

Setting Blocks What it does
Region all where the block is
Title, Show title / Display title system, View, menu a heading above the block; a View or menu block defaults to the View’s or menu’s name, a system block to its own (Recent comments)
Shows and the block’s own settings system see the table above
Initial level, Number of levels menu which part of the menu tree to show (Menus)
Load on scroll custom, View see below

Which block, View or menu a placement shows can’t be changed: delete it and add a new one. A View block is shown only while its View display is published; a View without a Block display can’t be placed.

Load on scroll puts a placeholder on the page and loads the block when the visitor scrolls close to it: useful for heavy blocks low on the page. While it loads, the theme’s placeholder for the region is shown, if it has one.

Each region is a table on the Blocks page, in the theme’s order. To rearrange:

  1. Drag a row by ☰ within its region or into another one, or choose another region in the row’s list (the row moves to the end of that region).
  2. Moved rows are marked until you save; a notice above the list reminds you.
  3. Press Save order.

Blocks in a region are shown top to bottom in this order.

Every block has two conditions, and both must match.

Roles. Tick the roles that see the block, Guest (not signed in) included. None ticked means everyone.

Visibility. Which pages show it:

Choice Shown on
Everywhere every page
Front page only the front page
Only on specific content types the pages of content items of the ticked types
Specific pages the pages listed under Pages

Pages takes one path per line, without the leading /. * matches anything (articles/* is every page under articles/), <front> is the front page. Then choose Show only on the listed pages or Show everywhere except the listed pages.

A View block with a contextual filter (related content, more from this author) needs Everywhere or Only on specific content types: it is built from the content item being viewed and is empty elsewhere.

Each theme has its own block layout. When more than one theme is installed, the Blocks page has a tab per theme, the active one marked. You can arrange an inactive theme’s blocks in advance; the site shows them once the theme is made the default on the Appearance page (/admin/config/appearance).

A theme without a layout of its own gets a copy of the active theme’s, in the regions with the same machine names, the first time its tab is opened or it is made active. A theme may also come with starter blocks (the bundled themes bring the copyright block in Footer bottom line; a theme can bring a custom block too, with its title and text). They are placed once, unless the layout already has them; after that they are ordinary blocks that you edit or delete, and the theme doesn’t bring them back.

Blocks are built ahead of time and kept in memory. Saving a block, the order or a View rebuilds them at once; content and comments reach View blocks within a few seconds (Views).