> For the complete documentation index, see [llms.txt](https://docs.varbase.vardot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas.md).

# Building Pages With Drupal Canvas

**Drupal Canvas** is the page builder in Varbase. You build a page by placing ready-made components, such as headings, images, cards and sliders, and editing them where they appear on the page. It is the feature to lead with when a client's marketing team will own the site. This section shows how to create pages, work in the editor, use every component, and publish your changes.

Watch the lesson: [Pages With Drupal Canvas](https://docs.varbase.vardot.com/content-designers/varbase-content-designers-course/lesson-08-pages-with-drupal-canvas-part-1.md) in the [Varbase: Content Designers Course](https://docs.varbase.vardot.com/content-designers/varbase-content-designers-course.md).

## Why It Matters

* Marketing builds and changes landing pages without a developer ticket. Developers still decide which components exist.
* Components come from the design system, so pages stay on brand however many people build them.
* Every change is a private draft until someone publishes it, so a live page can be reworked safely.

## Components and Patterns

* A **component** is one ready-made piece: a heading, text, an image, a button, a card, an accordion, a video. Each comes from the theme, so it already looks right. See the [Component Catalog](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/component-catalog.md) for every component and its settings.
* A **pattern** is a whole section built from components and filled with starter content, such as a page intro banner, feature cards or a call to action. Inserting a pattern is the fastest way to a good page. See [Patterns](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/patterns.md).
* **Live components** show content from elsewhere, such as the latest blog posts or a webform, and update themselves. See [Live Components](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/component-catalog/live-components.md).

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-c362a629c29d50aab453ab2808615526c7ef2e46%2Flearn-08-component-library.png?alt=media" alt="The Library panel of the Drupal Canvas editor on the Components tab, listing component groups such as AI, AI Dashboard, Announcements, Base, Block and Card with their components"><figcaption><p>The Component Library, Grouped by Family</p></figcaption></figure>

## What You Build With Drupal Canvas

* **Pages**: landing pages and other designed pages. The **Home**, **About Varbase**, **Features**, **Blog** and **Contact Us** pages of a new site are Drupal Canvas pages.
* **Content templates**: the layout of a content type, such as how every blog post looks. See [Content Templates](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/content-templates.md).
* **Page templates**: the header and footer around every page. See [Page Templates](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/page-templates.md).

Blog posts and utility pages are still filled in through a form. See [Content Management](https://docs.varbase.vardot.com/content-designers/content-management.md).

## The Pages List

Click **Pages** in the **Navigation** sidebar (`/admin/content/pages`) to see every Drupal Canvas page with its **Title**, **Status**, **Author** and **Updated** date.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-1e92dcf6653ddd939724bb4531065d3efdcd56cf%2Fcanvas-overview-01-pages-list.png?alt=media" alt="The Pages list with Home, About Varbase, Features, Blog, Contact Us and Search, each with its status, author, update date and Edit action"><figcaption><p>The Pages List</p></figcaption></figure>

## Creating a Page

1. On the **Pages** list, click **Add Page**.
2. Varbase creates an unpublished page called **Untitled page** and opens it in the editor.
3. In the **Page data** panel on the right, enter the **Title**.
4. Add components. See [Adding and Arranging Components](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/adding-and-arranging-components.md).
5. Publish the page. See [Preview and Publish](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/preview-and-publish.md).

For a full example from an empty page to published, see [Create a Page From a Pattern](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/create-a-page-from-a-pattern.md).

## The Editor

Click **Edit** next to a page to open it in the editor, for example `/canvas/editor/canvas_page/2` for the **Home** page. The editor takes a moment to load. Nothing you do there is visible to visitors until you publish. **Exit Drupal Canvas** in the top bar takes you back to the admin area.

{% embed url="<https://youtu.be/-DsRYLjgwn4>" %}
Finding Your Way in Drupal Canvas (Video)
{% endembed %}

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-e350fb2156f445e214114e33e34874b148be00c9%2Fcanvas-overview-02-editor.png?alt=media" alt="The Drupal Canvas editor with the left toolbar, the page in the middle, the Page data panel on the right and the top bar with the page name, Preview and Review changes"><figcaption><p>The Drupal Canvas Editor</p></figcaption></figure>

| Area              | What it holds                                                                                                                                                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Top bar**       | The page name (click it to switch pages), **Undo** and **Redo**, **Preview**, and the review button, which shows how many changes you have made, for example **Review 3 changes**.                                                                                  |
| **Left toolbar**  | **Library** (components and patterns), **Layers** (the outline of the page), **Pages**, **Templates** (for roles that manage templates) and **Translate**.                                                                                                          |
| **Page (middle)** | The page as visitors will see it. Click a component to select it. The controls under the page change the screen size (**Mobile**, **Tablet**, **Desktop**, **Large Desktop**) and the zoom (**Select zoom level**). Check the **Mobile** size before every publish. |
| **Right panel**   | **Page data** for the page itself, and **Settings** for the component you selected.                                                                                                                                                                                 |

### Page Data

**Page data** holds the page's own details:

| Field                | What it is for                                                                                                                                           |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title**            | The page name, shown in the browser tab and in lists.                                                                                                    |
| **Meta description** | The summary search engines show under the title.                                                                                                         |
| **URL alias**        | The page address, such as `/about-us`. It fills in from the title as you type the title, until you change it yourself.                                   |
| **Image**            | The picture used when the page is shared or shown as a card.                                                                                             |
| **Page template**    | Which page template (header and footer) the page uses.                                                                                                   |
| **Metatags**         | Detailed search and social sharing settings. See [Meta Tags](https://docs.varbase.vardot.com/content-designers/search-engine-optimization/meta-tags.md). |

Fill these early, so drafts are easy to find in the **Pages** list.

{% hint style="warning" %}
The browser's developer console shows errors every time the editor loads, for every role, and a **Content editor** sees one more about the **Administer page template** permission. Inserting a pattern can log another. These are known on Varbase 11.0 and the editor keeps working, so you do not need to report them.
{% endhint %}

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-541d703e11a2a881b2faf50b258da815c220e2fc%2Flearn-08-layers-panel.png?alt=media" alt="The Layers panel showing the page as a tree of sections, columns, a hero slider container with hero slides, headings, text and buttons"><figcaption><p>Layers: the Page as a Tree of Sections, Columns and Components</p></figcaption></figure>

## Page Actions

The **Pages** panel in the editor offers actions on whole pages: **Duplicate page** (a quick start for a series of similar pages), **Set as homepage**, **Unpublish page** and **Delete page**. Keep setting the home page and deleting pages for senior roles. Open the menu on a page (**Open contextual menu**) to see them. A section that works well can be saved as a new pattern for other editors; managing patterns needs the **Administer patterns** permission, held by **Content Admin** and **Site Admin**.

## Who Can Do What

| Task                                      | Content editor | Content Admin | Site Admin |
| ----------------------------------------- | -------------- | ------------- | ---------- |
| Create and edit pages                     | Yes            | Yes           | Yes        |
| Publish changes                           | No             | Yes           | Yes        |
| Delete pages                              | Yes            | No            | Yes        |
| Create patterns                           | No             | Yes           | Yes        |
| Edit content templates and page templates | No             | No            | Yes        |
| Translate pages                           | Yes            | Yes           | Yes        |

A **Super Admin** can do all of these. The **SEO Admin** role cannot edit pages, but can translate them.

{% hint style="info" %}
A **Content editor** prepares changes and asks a **Content Admin** or **Site Admin** to review and publish them.
{% endhint %}

## Questions Clients Ask

* **Can editors break the design?** Less than with free-form builders: they choose from approved components and the variants the design system allows. Permissions decide who edits patterns, templates and code components.
* **Is Layout Builder gone?** It is still present for older content, but new pages in Varbase Starter are Drupal Canvas pages. Plan new builds on Canvas.

## Planning Notes

* Walk the client's designs and the pattern list side by side. Sort each section into existing patterns, patterns to restyle, and new patterns. The new ones are where design and development time goes.
* Count unique components in the design, not pages; that drives front-end effort.
* Agree the publishing split: editors build pages, a **Content Admin** or above publishes them.
* Drupal Canvas pages have no URL alias pattern: the editor fills **URL alias** from the title, and nothing updates it later. They are not in the XML sitemap on Varbase 11.0. Plan each page's address and how landing pages reach search engines.

## In This Section

* [Component Catalog](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/component-catalog.md)
* [Adding and Arranging Components](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/adding-and-arranging-components.md)
* [Patterns](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/patterns.md)
* [Create a Page From a Pattern](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/create-a-page-from-a-pattern.md)
* [Page Types and Templates](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/templates-and-page-types.md)
* [Content Templates](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/content-templates.md)
* [Page Templates](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/page-templates.md)
* [Preview and Publish](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/preview-and-publish.md)
* [Translating a Page](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/translating-a-page.md)

## Tips

* Start from a pattern rather than a blank page; it is faster and stays on brand.
* Your work is saved as you go. Nothing is live until it is published.
* The [Drupal Canvas guides for developers](https://docs.varbase.vardot.com/developers/theme-development-with-varbase/drupal-canvas.md) show more examples, such as accordions and hero sliders.
