> 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/understanding-varbase/varbase-recipes/varbase-canvas-base.md).

# Varbase Canvas Base

The **Varbase Canvas Base** recipe installs **Drupal Canvas** and **Canvas Override** on a Varbase site. It installs modules only: no content types, no fields and no permissions.

## Drupal.org Project

<https://www.drupal.org/project/varbase_canvas_base>

## Overview

Varbase Canvas Base was added to **Varbase Starter** in Varbase 11.0.0 ([#3620193](https://www.drupal.org/i/3620193)) and is applied right after **Varbase Content Base** ([#3621018](https://www.drupal.org/i/3621018)).

Related pieces stay in the recipes that own them:

* The Canvas page and component library permissions are granted by **Varbase Content Base**, because a Canvas page is content.
* **Canvas Translate** comes with **Varbase Internationalization Base**.
* **Canvas Icon Picker** comes with **Varbase Admin Base**.
* The Canvas text format permissions come with **Varbase Editor Base**.

The Vardot site templates (**Educare**, **Horizon Aid**, **The Rightup**) do not require this recipe. They get the `canvas` module from **Varbase Media Base**, which they apply directly.

## Included Modules

| Module                                                                | Purpose                                                                                                         |
| --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| [**Drupal Canvas**](https://www.drupal.org/project/canvas)            | The visual page builder: Canvas pages, the component library, patterns, content templates and page templates.   |
| [**Canvas Override**](https://www.drupal.org/project/canvas_override) | Per-item Canvas layouts on the full view mode of selected content types. Off by default for every content type. |

## Turning On Per-Item Layouts

Canvas Override is installed but not switched on. No content type has it enabled, so `/node/<id>/canvas` answers 403, even for the Super Admin, and no content item shows a Canvas layout tab. To use it:

1. Go to **Structure** \ ***Content types*** and edit the content type, for example **Blog post**.
2. Open the **Canvas layout** vertical tab.
3. Tick **Enable per-content Canvas layout editing on the full content view mode**.
4. Save the content type. Canvas Override adds a `field_canvas_layout` field and sets the full and default displays to render it.

The **Canvas layout** tab needs **Administer Canvas Override**. Who may edit per-item layouts is set by **Use Canvas Override for all content types**, or by the per-type permission, such as **Blog post: Use Canvas Override**. See [Known Issues on a New Varbase 11 Site](https://docs.varbase.vardot.com/developers/known-issues-on-a-new-varbase-11-site.md).

## Installation

Apply the recipe using Drush:

```bash
ddev drush recipe ../recipes/varbase_canvas_base
```

This recipe is applied automatically by the **Varbase Starter** site template.

## Related

* [Drupal Canvas](https://docs.varbase.vardot.com/developers/theme-development-with-varbase/drupal-canvas.md)
* [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)
