> For the complete documentation index, see [llms.txt](https://salsa-digital.gitbook.io/govcms-site-builder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://salsa-digital.gitbook.io/govcms-site-builder/unit-1-functional-analysis/blocks-in-govcms.md).

# Blocks in GovCMS

*Blocks* are pieces of your site’s web page layout. They are placed inside the *regions* of your theme, and can be created, removed, and rearranged in the *Block layout* (*admin/structure/block*) administration page. Examples of blocks include the *Who’s online* listing, the main navigation menu, and the breadcrumb trail. The main page content is also a block.

Some modules make new blocks available for placement on your site. For example, when the core **Search module** is installed and configured, it provides a block that contains a search form. You may also create and place your own custom blocks.

Each block has its own configuration settings, which allow you to select which pages of your site will display the block. It’s even possible to place multiple copies of a block, each with its own separate configuration and visibility rules.

## Block administration review

On the *Admin menu* hover over *Structure* then click on **Block layout**.

The block admin page shows you the blocks on your site and where they’re displayed. In the default GovCMS (Olivero) theme, the main navigation, user account menu and site branding blocks are spread across various regions.

You can change the order of the blocks displaying by using the four-way arrow icons and dragging and dropping the blocks up or down. Once you’re happy with the position, scroll to the bottom of the page and click the **Save blocks** button.

![](https://3186608908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzAsrTcKaHnLDg-7ALW%2Fuploads%2Fgit-blob-8073f9d007d7e7a794f5c56f0c18f710b74e62c6%2FUnit-1-Block-Admin-1.png?alt=media)

## Disabled blocks

Depending on what modules you have installed, various new blocks become available for activation in any of the site regions. You may explore available blocks by clicking the “Place block” button in the desired region:


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://salsa-digital.gitbook.io/govcms-site-builder/unit-1-functional-analysis/blocks-in-govcms.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.