> 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/developers/theme-development-with-varbase/drupal-canvas/introduction-to-drupal-canvas-in-varbase.md).

# Introduction to Drupal Canvas in Varbase

What Drupal Canvas is and how it works in Varbase, the visual, drag-and-drop page builder in the Vartheme BS5 theme, with no code.

**Drupal Canvas** is the visual page builder that comes with **Varbase**. You build and arrange pages by dragging ready-made pieces onto the page and editing them right in the browser, **no code**. What you see while you edit is what visitors see.

## What You Can Build

* **Pages**: full pages you compose from components (for example a landing page). Varbase's Home, About, Features, Blog and Contact pages are built this way.
* **The Header and Footer**: the site-wide bars at the top and bottom of every page. In Drupal Canvas they belong to a **page template** you can edit visually too.

## The Key Ideas

| Term                | What it means                                                                                                                           |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Page**            | A page you build with Drupal Canvas. All your pages are listed under **Pages**.                                                         |
| **Component**       | A ready-made piece you place on the page, a heading, an image, a button, a card, an accordion, a hero slider, a menu, a form, and more. |
| **Page template**   | A shared layout around every page, holding the **Header** and **Footer**. Changing it changes every page that uses it.                  |
| **Layout**          | Containers such as **Section** and **Columns** that hold components and arrange them side by side or stacked.                           |
| **Draft & Publish** | Your edits are saved as a private **draft** while you work. Nothing is live until you **Publish**.                                      |

## Where Your Pages Live

Go to **Administration** \ **Content** \ *Pages* (`/admin/content/pages`). This lists every Drupal Canvas page with its title, status (Draft or Published), author and last-updated date. Use **+ Add Page** to create a new one, or **Edit** to open a page in the editor.

![The Pages list in Varbase, where every Drupal Canvas page is created and managed](https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-d8e87d04d927ae389558fca38756c90b05027c43%2FCanvas%20Introduction%20-%20Pages%20List.png?alt=media\&token=79dea37e-636b-416e-b500-ece9f99055a1)

## The Editor at a Glance

Opening a page opens the Drupal Canvas editor. It has three main areas:

* **Left toolbar**: the **Library** (all the components you can add), the **Layers** panel (the outline of everything on the page), and more.
* **Canvas (middle)**: a live preview of the page. You can switch the view between **Mobile**, **Tablet** and **Desktop**, and zoom in or out.
* **Settings (right)**: the options for whatever you have selected (the page, or a single component).

The picture below shows the **Layers** panel open: a page is simply a tree of components. The top bar shows the page name, whether it is **Published**, a **Preview** button, and the publish button that lights up when you have unsaved changes.

![The Drupal Canvas editor: left toolbar with Library and Layers, the canvas preview in the middle, and the settings panel on the right](https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-e71ff876634c93e1fd735e651bd85940637ea003%2FCanvas%20Introduction%20-%20Editor%20Overview.png?alt=media\&token=b1b7b515-ce9b-4b2c-8c59-3099acfb32fb)

## How You Work: Draft, Review, Publish

1. **Edit**: add components from the Library, arrange them, and change their settings. Everything you do is saved automatically as a **draft**.
2. **Review changes**: see what you changed before it goes live.
3. **Publish**: make your changes visible to visitors. Below is a published page as a visitor sees it.

![A published Drupal Canvas page as visitors see it](https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-80364a6705003ff6adaf6dddc5d0e7137d0a34cd%2FCanvas%20Introduction%20-%20Live%20Page.png?alt=media\&token=a8640ee6-1477-485c-8878-cc0a80faecbf)

## Who Does What

| Role                                  | Typical tasks                                                                                                                                                             |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Content Designers** / site builders | Create and edit pages, add and arrange components, add images, links and text, and publish. Edit the header and footer when allowed.                                      |
| **Developers**                        | Provide the building blocks (theme components), decide which components are available, set who can edit and publish, and build advanced pieces such as content templates. |

{% hint style="warning" %}
**Permissions.** Some actions are limited, for example, editing the global header and footer needs a specific permission. Your administrator decides who can do what.
{% endhint %}

## How Drupal Canvas Fits With Varbase

It uses the building blocks that come with the **Vartheme BS5** theme, so pages match your site's look automatically.

## Where to Go Next

* [**Component Reference: Vartheme BS5 in Drupal Canvas**](https://docs.varbase.vardot.com/developers/theme-development-with-varbase/drupal-canvas/vartheme-bs5-components-in-drupal-canvas.md), for developers
* [**Component Catalog**](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/component-catalog.md), for editors: every component and its settings
* [**Building Pages With Drupal Canvas**](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas.md), the editor guide in Content Designers
* [**Editing the Header and Footer With Drupal Canvas**](https://docs.varbase.vardot.com/developers/theme-development-with-varbase/drupal-canvas/editing-the-header-and-footer-with-drupal-canvas.md)
* [**Managing Multiple Accordions With Drupal Canvas**](https://docs.varbase.vardot.com/developers/theme-development-with-varbase/drupal-canvas/managing-multiple-accordions-with-drupal-canvas.md)
* [**Hero Slider Container and Hero Slide With Drupal Canvas**](https://docs.varbase.vardot.com/developers/theme-development-with-varbase/drupal-canvas/hero-slider-container-and-hero-slide-with-drupal-canvas.md)
* [**Varbase Canvas Base**](https://docs.varbase.vardot.com/developers/understanding-varbase/varbase-recipes/varbase-canvas-base.md), the recipe that installs Drupal Canvas
