> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/volume-themes/theme-settings/layout.md).

# Layout

Configure Volume layout: set page margins, section spacing, and choose between three grid variations with full-width toggles, max widths, and gap controls.

Basic layout settings such as **Left and right margins** and **Spacing between sections** are complemented by fine-tuned control over three grid variations.

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2F4NEO6knfwHUhxLjYrTcD%2Fsection-grid.gif?alt=media&amp;token=c8cd7bab-5f97-4585-ae96-1f67a7601ebb" alt=""><figcaption></figcaption></figure>

{% hint style="success" icon="lightbulb" %}
Each grid can be applied to any section under **Section layout** subtitle.
{% endhint %}

***

### Grid Settings

Each grid configuration includes:

* **Full-width** — Expands the content to the full width of the browser window.
* **Max width** — If Full-width is disabled, you can set a maximum width for the section.
* **Column and row gap** — Adjusts the spacing between elements.

#### Page Grid

The primary grid used for most sections with standard width and gaps.

#### Secondary Grid

An additional grid that allows for variations in width and spacing.

#### Alternative Grid

Designed for specific sections, such as navigation.

***

### Applying Grids

Each of the three grids can be applied to any section.

Additionally, within a section, you can individually configure specific grid parameters. These section-level settings override the selected grid settings:

* **Make full-width**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2Fs7WGOXjWUOID6iVgniNX%2Ffull-width.gif?alt=media&amp;token=6a9d73b8-45d3-43d3-9ea6-694150c403f8" alt=""><figcaption></figcaption></figure>

* **Disable grid max-width**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2F7PG7ebqlgWkYHKAYMoJa%2Fdisable-grid-max-width.gif?alt=media&amp;token=765c3f1a-d5f3-4002-a356-6b9aa9477809" alt=""><figcaption></figcaption></figure>

* **Disable grid gaps**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2Ff3PlvwYHOIONdgVzu6TW%2Fdisable-grid-gaps.gif?alt=media&amp;token=585ff2c7-4611-4037-9c44-63353deccbac" alt=""><figcaption></figcaption></figure>


---

# 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://staylime.com/docs/volume-themes/theme-settings/layout.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.