How do I create a layout?

Introduction

A layout is a reusable template that defines the structure of a page. You can create unique layouts for individual pages or use them to maintain consistency across similar types of content, such as blog posts or managed pages.

Layouts make it easy to combine structured design with editable content, giving you control over how elements appear while allowing site editors to manage content visually in the dashboard.

Creating a layout

Create a `layouts` folder

In your project’s views directory, create a new folder called layouts.
This directory will hold all your layout templates.

Add a new layout file

Inside the layouts folder, create a new HTML or Canvas file.
Name it based on its structure or purpose—for example:

about.html
long-text-bottom-image.html

This naming helps you identify each layout at a glance.

Extend the default template

Inside your new layout file, begin by extending your site’s base template:

{% extends 'templates/default' %}

{% block body %}
  {# Your layout code goes here #}
{% endblock %}

All content for your layout should be placed within the {% block body %} section.

Push your layout to Blutui

Once saved, push your new layout to Blutui by running:

courier push

If you’re already running courier dev, your layout will automatically sync with your local environment.

Introduction

Creating a layout

Create a `layouts` folder

Add a new layout file

Extend the default template

Push your layout to Blutui

Next steps

How do I create a page in the dashboard?

How do I add Canopy elements to a layout?

How do I push a project to Blutui?

On this page

How do I create a layout?

Introduction

Creating a layout

Create a layouts folder

Add a new layout file

Extend the default template

Push your layout to Blutui

Next steps

How do I create a page in the dashboard?

How do I add Canopy elements to a layout?

How do I push a project to Blutui?

On this page

Create a `layouts` folder