> 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/adding-and-arranging-components.md).

# Adding and Arranging Components

A Drupal Canvas page is a stack of components: sections, columns, headings, text, images, buttons, cards and more. This page shows you how to add components, change their content, and move, copy or remove them.

## Adding a Component

1. Open the page in the editor.
2. In the left toolbar, click **Library**. The **Components** tab lists every component, grouped in folders.
3. Type in **Search…** to find one, for example `Heading`.
4. Drag the component onto the page. A line shows where it will drop.

   You can also right-click the component in the **Library** and choose **Insert**. It is added next to the selected component, or into the page if nothing is selected.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-60d39fae4356826d31952bbc3ff49ddb46230178%2Fcanvas-components-01-library.png?alt=media" alt="The Library panel open on the Components tab, with Heading typed in the search box and the Heading component listed"><figcaption><p>Adding a Component From the Library</p></figcaption></figure>

{% hint style="info" %}
Layout components such as **Section** and **Columns** hold other components. Add the layout first, then drop components into it.
{% endhint %}

## Changing a Component

1. Click the component on the page. A frame shows it is selected.
2. Change its content and options on the **Settings** tab of the right panel, for example the heading text, the heading level or the link of a button.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-4f0a35978d77b16472943f73664dc1fe4aacc756%2Fcanvas-components-02-settings.png?alt=media" alt="A Heading component selected on the page, with its text and heading level shown on the Settings tab of the right panel"><figcaption><p>Changing a Component's Settings</p></figcaption></figure>

The page updates as you type.

## Arranging Components With Layers

**Layers** in the left toolbar shows the page as an outline: every component, and the components inside it.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-32f8760093b9c642b4c50bd7c0d9b7eb652c224e%2Fcanvas-components-03-layers.png?alt=media" alt="The Layers panel showing the outline of a page, with sections that contain columns, headings and cards, and one Section layer selected"><figcaption><p>The Layers Panel</p></figcaption></figure>

* Click a layer to select that component on the page.
* Drag a layer up or down, or into another layer, to move the component.
* Click the arrow next to a layer to show or hide what is inside it.

Use **Layers** when components are small or nested and hard to click on the page.

## Moving, Copying and Removing

Right-click a component on the page or in **Layers** to open its menu:

| Item                   | What it does                                                                                                                                                                      |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Duplicate**          | Adds a copy straight after it.                                                                                                                                                    |
| **Copy** and **Paste** | Copies it, then pastes it after the selected component.                                                                                                                           |
| **Create pattern**     | Saves it as a reusable pattern (for roles that manage patterns). See [Patterns](https://docs.varbase.vardot.com/content-designers/building-pages-with-drupal-canvas/patterns.md). |
| **Move**               | **Move up**, **Move down**, or into another container.                                                                                                                            |
| **Delete**             | Removes it from the page.                                                                                                                                                         |

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-5af98c917f4715b81e99e0a9f6fb141fbcca1650%2Fcanvas-components-04-context-menu.png?alt=media" alt="The right-click menu of a component with Duplicate, Copy, Paste, Create pattern, Move and Delete"><figcaption><p>The Component Menu</p></figcaption></figure>

With a component selected, you can also press **Ctrl + C** and **Ctrl + V** to copy and paste, and **Delete** to remove it (on a Mac, use **Cmd**). **Undo** (**Ctrl + Z**) and **Redo** in the top bar take back a step.

## Adding Images and Links

* An image setting opens the **Media Library**: pick an image or upload one, and fill in its alt text. See [Media Management](https://docs.varbase.vardot.com/content-designers/media-management.md).
* A link setting accepts a page on your site (start typing its title) or a full web address.

## Tips

* Build with layout first: a **Section**, then **Columns**, then content.
* Keep headings in order on the page (a **Heading 2** before any **Heading 3**).
* Check the page at the **Mobile** size before publishing; columns stack on small screens.
