Bubble Pages & Blocks

Expand your application by adding Bubble pages, blocks & elements to your template using the Canvas Extension.

Your Canvas template is installed with several pages that provide login, account, and admin functionality. However, your template can be extended far beyond this by taking advantage of dozens of prebuilt Bubble pages and blocks available to you in the Canvas library.

Installing the Chrome Extension

In order to be able to add Bubble pages and blocks to your Canvas template be sure to install the Chrome extension.

With the Canvas Chrome extension installed, please follow the instructions below:

1. In your Chrome browser, click on the puzzle icon in the upper right corner

2. Find Canvas by Airdev and click on the pin next to it to pin it to your Chrome browser for easy access

3. Click the Canvas icon to open and close the extension

View a list of all pages and blocks available through Canvas here

Do I need to register my Canvas application with the Build Hub to use the Canvas extension?

As of Sep 5, 2023 (template version 5.1.0), we have removed the manual registration flow in the template to register your app with the Build Hub. If your app template version is v5.1.0 or later, you can simply open the Canvas extension from your app editor to add free assets. If you are using an older template, you can self-register your application with the Build Hub using this link.

Adding a new page

With the Canvas extension open, click on 'Pages' to open the library of Bubble page templates.

Select the page you would like to add and click the 'Add page' button. The unique path entered here will also be the name of your new Bubble page.

When creating your page, Canvas will also create a corresponding option in the Bubble Pages option set. You will need to set this option up with the correct privacy and role permissions for each Bubble page you create.

Customizing your page

Some page templates will include a page-level group with a collapsible image banner, title, description, and toggle tabs. This group should be used when you want to further customize a page.

Page Flair Group with page title and description visible

Page Flair Group with page title, description, and toggle tabs visible

Page Flair Group with image banner, page title, description, and toggle tabs visible

• To show an image banner, unhide the placeholder group by checking the box for This element is visible on page load and change the group's style to an empty style. Change the background of the group by selecting a background type and entering the relevant fields.

• Show or hide the other UI components in the Page Flair group to fit your needs.

Your page is now a fresh canvas ready to go. Start building it out by adding blocks from the Canvas library!

Adding blocks to the page

A block is a group of Bubble elements arranged in a way that is responsive, cohesive with Canvas design standards, and has some functionality that you can use in your app.

To add a block, open the extension and select 'Blocks' from the sidebar. The library of Canvas blocks already contains dozens of Free and Premium options and we are constantly adding new options to the list.

From the 'Add to' dropdown, select the group that you would like to add a block to. Click the 'Add' button to start building out your page.

Setting up blocks you have added

Adding blocks using Canvas Pages is only the first step to extending the functionality of your app. In order to make the most of the Canvas blocks, you need to modify these blocks in a few different ways:

• Adding or modifying actions on buttons

• Changing data sources on repeating groups or elements with data sources

• Filling out content on groups

• Linking content on groups to data types

• Linking blocks to portal tabs (show/hide based on what user selects)

Customizing block title group

Most blocks will include a standard title group. This group includes common UI components such as a title, dropdown, toggle tabs, description text, sort dropdown, filters, and a 'new' button.

Title Group with Category dropdown visible

Title Group with Toggle tabs visible

Title Group with Description/Results text visible

The dropdown, toggle tabs, and description/results text are within three separate collapsible groups. You can set any of those groups to be visible or not visible on page load.

Adding blocks with functionality

Some blocks in Canvas already have functionality that is preconfigured for your app. Adding these blocks to your app is another way to quickly extend the template.

More complex blocks also require some customization as well as specific data types and fields to be added to your application in order to work properly. Please see the documentation for these blocks to learn how to set them up.

Adding elements to blocks

An element is a small and foundational UI that you can add to any Canvas page or block to further customize it.

To add an element, open the extension and select 'Elements' from the home screen.

From the 'Add to' dropdown, select the group that you would like to add an element to. Click the 'Add' button to start customizing your blocks.