Canvas Documentation
Bubble Best Practices
v3.7
v3.7
  • Introduction
  • Key Features
  • What's New
  • For Designers
  • CANVAS FUNCTIONALITY
    • Getting Started
    • Branding & Design
    • Marketing Pages
    • Bubble Pages & Blocks
    • Roles & Permissions
    • Menus & Navigation
    • Data & Workflows
    • Emails & Alerts
    • Miscellaneous
      • Setting up two factor authentication
      • Cookie and consent banner
      • Setting your password policy
      • Set up Payment info on Account page
      • Loading screen
      • Configuring multiple languages
      • Customizing your app's portal page colors
    • Reference
      • Pages
        • Index
        • Admin Portal
        • Account
        • Login
        • Legal
        • Reset Password
        • 404
      • Reusable elements
        • Header
        • Footer
        • Signup & Login
        • Cookies Permission
        • Widgets
          • App security
          • Header Widgets
          • Workflow Widgets
        • Admin Portal
          • Admin analytics
          • Admin email & templates
          • Admin header & footer
          • Admin legal popups
          • Admin branding, launch, and settings
          • Admin marketing pages
          • Admin portal canvas logic
          • Admin options settings
        • Menu Focus Elements
      • Data types
      • Option Sets
      • Backend Workflows
      • Design standards
        • Manually Building UI
  • Bubble Best Practices
    • Learning Bubble Basics
    • Principles
    • Database
    • Design
    • Security
    • SEO
    • Speed
    • Modularity
      • Data triggers
  • Canvas library
    • Page templates
      • Free Bubble Marketing Page
      • Premium Bubble Marketing Page
      • Centered Profile Page
      • Left-Justified Profile Page
      • Standard page
      • Toggle Tabs Page
      • Menu Page
      • Mobile Menu Page
      • Video List Page
      • Standard Portal / Dashboard Page
      • Simple Portal / Dashboard Page with Icons
      • Double Sidebar Portal Page Template
      • Search Page
      • Map Search Page with Toggle and Filters
      • Floating Map Search Page
      • Search Bar Page
      • Multi-Step Page With Progress Bar
      • Standard Multi-Step Process Page
      • Multi-Step Process Page with Sidebar
      • Gallery Profile or Product Page
      • Sidebar Profile Page
      • 2-Column Menu Tabs Page
      • 2-Column Checkout Page
      • 2-Column Video Chat Page
      • Vertical Multi-Step Page Template
    • Blocks
      • Monthly Calendar Scheduling Widget
      • No Reply Comments Thread
      • Nested Comments Thread (with Like and Reply)
      • Placeholder Group
      • List with Circular Progress Bar Repeating Group
      • Top Input Chat Widget
      • Bottom Input Chat Widget
      • Toggle Tabs Group
      • Single-Select or Multi-Select Pill Tabs Group
      • Settings group
      • To-Do List Repeating Group
      • Title Group with Button and Filters
      • Product Details Group With Progress Bar
      • Listing details with Icons and Menu Focus Group
      • Week Daily Availability Group
      • Frequently Asked Questions (FAQ) Repeating Group
      • Dismissible Module
      • Video Group
      • About Group
      • Add to Cart Group
      • Full Width Map with Directions Link
      • Location Module (Map and Directions)
      • Drag and Drop Repeating Group
    • Popups
      • Confirmation Popup
      • Message Popup
      • Image Popup
      • Video Popup
      • Vertical Scroll Popup
      • Edit Popup
      • Standard Form Popup
      • Subscribe Popup
      • Feedback / Contact Popup
      • Details Popup
      • Add List Popup
      • Advanced Form Popup
      • Rating Popup
      • Toggle Tabs Popup
      • Share Popup
      • Multi-Step Popup
      • Invoice Popup
      • Stripe Credit Card Purchase Popup
      • View Profile Popup
      • Send Message Popup
      • Multi-Select Pill Tabs Popup
      • Pricing Plans Popup
Powered by GitBook
On this page
  • November 19, 2021 (patch 3.7.3)
  • October 29, 2021 (patch 3.7.2)
  • October 11, 2021 (patch 3.7.1)
  • October 7, 2021 (release 3.7.0)
  • Revised sign up/log in flow to include two factor authentication option
  • Portal pages color palette generator
  • UI updates
  • July 22, 2021 (patch 3.6.2)
  • July 21, 2021 (patch 3.6.1)
  • July 19, 2021 (release 3.6.0)
  • Create custom headers for multiple user types
  • Reveal password functionality
  • Developer mode
  • Changes to Website data type
  • New data type to contain app wide variables
  • Core Canvas element indicators
  • Email templates
  • LocalizeJS integration
  • June 7, 2021 (release 3.5.1)
  • New loading screen element
  • Deprecated the popup_reusable element
  • May 24, 2021 (release 3.5.0)
  • Added Postmark as an email provider
  • Converted various things to reusable elements
  • Added new UI to settings tab in the admin portal (e.g. sample single field and sample picklist)
  • Page Builder
  • March 30, 2021 (release 3.4.0)
  • Base Template
  • Chrome Extension
  • December 29, 2020 (release 3.0.0)
  • Admin Portal Redesigned
  • Page Builder
  • Chrome Extension
  • Pages option set updated
  • Fewer nested groups
  • Send custom Sendgrid emails on a hobby plan

Was this helpful?

What's New

If you've been a long time Canvas user, you can catch up on all the changes and improvement that have been made right here!

PreviousKey FeaturesNextFor Designers

Last updated 3 years ago

Was this helpful?

November 19, 2021 (patch 3.7.3)

Added a new option set for Navigation Widget Type. These are used in the admin portal's header/footer tab to open built-in widgets (e.g. search, messages, notifications, and cart) from the header. Please do not edit or remove these.

2FA bug fix In previous v3.7 versions, a new admin user added from the admin portal will be prompted to go through 2FA, even if 2FA is not enabled. Resolved this issue by setting the user's date last verified field to Current date/time when a new admin user is added from the admin portal.

Initial run as admin load time Added notes to the HTML message elements on the /index and /page pages about the run as admin load time. We are currently seeing that the 'run as' functionality could take up to 90 seconds to 'run as admin' and redirect to the admin page (this only happens the first time you do this). Please note that this is a Bubble issue and we are currently actively investigating this with the Bubble team.

October 29, 2021 (patch 3.7.2)

Dynamic logo links for headers

Added the ability for admins to set each header's logo url from the admin page.

Loading screen element bug fix (Canvas UI elements plugin)

If your Base Template is on v3.7.1 or earlier, please read our on how to fix the bug in your app.

October 11, 2021 (patch 3.7.1)

Resolved an issue where portal sidebar styles aren't visible to logged out users due to default privacy rules settings on the App settings data type. If your Base Template is on v3.7.0, please be sure to update the privacy rules settings to match the rules .

October 7, 2021 (release 3.7.0)

Revised sign up/log in flow to include two factor authentication option

The sign up and log in flow has been completely revised an upgraded to provide a more modern experience as well as offer additional security features.

Email verification

Previously Canvas would send an email to the user with a link they can click to verify their email address. We've revised this flow and now send a code to the user's email that they can submit directly in the sign up screen. This precludes the user from being navigated to a different screen on email verification and keeps the signup flow more focused.

Email verification requires the user's app to be on a paid Bubble plan.

Two factor authentication

We are excited to now offer two factor authentication for your users! Two factor can be required for all the users in your application or you can allow each user to require it only for their account.

Two factor authentication requires a paid account with Twilio and Bubble

Password reset

The password reset functionality now resets the user's password and then sends them through the full login flow before allowing the user to access your application.

Portal pages color palette generator

The "Update your portal page sidebar styles" within the "Branding" tab of the admin portal has been updated so that you can generate a custom color palette for your portal pages based on a single base color. You can also adjust the modes of each sidebar type from "dark" to "light" mode within this popup.

UI updates

Account page

The UI on the account page has been redesigned to bring it in line with the functionality present throughout the rest of the Canvas template.

New toggles

We have replaced the toggle elements throughout the template with a new smaller toggle. Please make sure your Canvas UI elements plugin is on the latest version (Bubble editor > Plugins tab > Canvas UI elements > Currently installed version dropdown).

Admin portal > Settings tab > Password policy popup

Minor updates to the UI in the password policy popup to use the new Canvas toggles instead of checkboxes.

July 22, 2021 (patch 3.6.2)

July 21, 2021 (patch 3.6.1)

Resolved an issue with the adding new pages from the extension where the header was not properly linking to the reusable element resulting in a 'deleted reusable element' error.

Resolved an issue with the with the LocalizeJS integration where it was not properly setting the selected language.

Updated the language selection popup for logged out users so that the language they select persists through the sign up process.

July 19, 2021 (release 3.6.0)

Create custom headers for multiple user types

The header has been rebuilt from the ground up and comes with a bunch of shiny new features.

  • Built entirely with html to speed up the loading time

  • Create or clone many different headers and show them only to specific user roles

  • Trigger Javascript function from any of the links or icons

  • Visually managed entirely from the Canvas admin portal

Reveal password functionality

Users can now choose to show or hide their passwords when entering their passwords in a password input field on the login, account, and reset_pw pages. This functionality helps users verify if they've entered their passwords correctly.

Developer mode

We've added a new Is developer? field to the User data type. Any user with an Admin role can enable developer mode in the admin portal under the Settings tab. Enabling developer mode will reveal advanced template settings that would require Bubble knowledge.

Changes to Website data type

The Website data type has been renamed to ⚙️ App settings as that seems to more accurately reflect the function it serves throughout the app. As a result, variables referring to this data type have also been renamed to var - ⚙️ App settings.

New data type to contain app wide variables

There has been some confusion with our users around what they are able to edit/update on the ⚙️ App settings object. To help remedy this we have created a new data type called App variables for you to use for anything that you need to reference throughout your application.

Simply add the fields you need and reference var - App variables on your pages to access data from this data type.

Core Canvas element indicators

We have added a gear icon (⚙️) before all reusable elements, data types, and field names that are core to the Canvas template. In general, these elements should not be edited unless you understand the impact changes will have on the template.

Email templates

Dynamic button text

You can now manage the button text for an email directly in the template! Simply check 'Include a button in this email' and you can define the button text directly from the admin portal.

Multi-language support

If you are setting up support for multiple languages in your app, you can now create email variants directly in the admin portal to support those languages.

Template folders

It's now much easier to keep your email templates organized! Use our new folder system to organize your templates into labeled folders to keep similar templates grouped together and easy to find.

LocalizeJS integration

Support for LocalizeJS is now a core function of the Canvas template!

June 7, 2021 (release 3.5.1)

New loading screen element

To use the loading screen element, you would need to first upgrade the Canvas UI Elements plugin version in your app to at least v1.4.0. The element allows you to display a loading animation while your page's elements and data are being loaded beneath. You will want to include this on every page where you want this behavior and have it be visible by default.

The loading element is active on the Admin portal by default.

Deprecated the popup_reusable element

The popup_reusable element has been deprecated. The elements it housed were either not being used often, or are now available elsewhere:

  • popup_signup/login - available as a standalone reusable

  • messagePopup - not being used often and removed from the template

May 24, 2021 (release 3.5.0)

Added Postmark as an email provider

We’ve just released an update which allows seamless integration of Postmark into Canvas apps. Postmark is known for prioritizing deliverability and cutting down on spam sent from their service so that your emails are more likely to get into your users’ inboxes instead of landing in their spam boxes.

To enable this on older versions of canvas, please go to your Bubble editor and upgrade the plugin version for ‘Email for Canvas’ (the plugin used to be called SendGrid for Canvas, but we changed the name with this release).

There is backward compatibility with old Canvas apps which allows your existing SendGrid flow to keep working the same way it was working on the previous plugin version when you upgrade the SendGrid plugin. In older Canvas apps, setting up Postmark takes some extra effort, but is much easier than adding a new plugin to your app.

Note that Postmark is primarily used as a transactional email service, and that our Postmark integration requires some modifications to support marketing emails. Postmark also has more stringent requirements for email quality than SendGrid, primarily measured by the portion of spam reports received relative to the total number of messages sent.

Converted various things to reusable elements

In the admin page, we’ve converted some (more) things to reusable elements to make it easier to edit the functionality in just one place and to follow the build pattern we’ve used in the rest of the admin page.

The data type 1 tab content is now a reusable element called admin_datatype1, and it currently contains Dummy data. To use this with a new data object, you would clone this reusable and Group Nav 8 - Data type 1 content in the admin portal. You would replace admin_datatype1 in the new group with the new reusable

User filters in the admin portal is also now a reusable element called filters_users.

Added new UI to settings tab in the admin portal (e.g. sample single field and sample picklist)

For this, we’ve created a new reusable element called admin_options_settings .

Page Builder

New marketing page backgrounds We've added 6 new marketing page backgrounds to the page builder

New hero blocks We've added 10 new hero blocks to the page builder. You can mix and match these new hero blocks with other page builder blocks and create beautiful marketing pages

March 30, 2021 (release 3.4.0)

Base Template

All new styles (version 003)

We've revamped our entire library of styles and this Canvas update comes with more than 300 new Bubble styles! Most page elements now have access to at least three different styles with support for different font weights (regular, semibold, and bold).

Consolidated legal page

Log in page redesigned

New Customizable Blocks

Chrome Extension

Along with the new styles, we have added a brand new design library of all the Canvas pages and blocks. These elements will be used for all new Canvas templates.

If your app is on a version previous to v3.4.0 you can continue to add new pages & blocks from the extension and the elements added will be add with the style version your app is based on.

However, if you would like to take advantage of the new styles and elements, you will see a banner prompting you to import the new styles (003). Once you've imported the new styles you are able to toggle between the new design library and and the old design library to add new elements.

December 29, 2020 (release 3.0.0)

Admin Portal Redesigned

Page Builder

Chrome Extension

Pages option set updated

We have made a couple key changes to the Pages option set.

  1. The Pages option set has been renamed to Bubble Pages to differentiate it from the new Marketing pages feature

  2. Previously we stored a list of Bubble Pages on the Role option set to define the pages a user was allowed to view. To simplify this, the Bubble Pages option now stores the list of Roles that can view that page enabling you to set a page's privacy status and define the roles that are allowed to view that page from the same place.

Fewer nested groups

We realize in the past that Canvas blocks contained a lot of extra groups nested within other groups. As of this release, we have rebuilt all the Canvas blocks to minimize the number of groups that are used while still maintaining a fully responsive template!

Send custom Sendgrid emails on a hobby plan

With a brand new Sendgrid plugin we have moved the default email functionality to the front end instead of the using backend workflows. This means you can now send emails through Sendgrid with our beautiful HTML template without being on a paid Bubble plan.

The backend email functionality is still available for more robust email setups and scheduling.

Resolved an issue with the new header and footer elements where they would not be shown if the user was running an ad blocker in their browser. If your version of Canvas is 3.6.0 or 3.6.1, please see our forum post for how to resolve this issue .

The element can be found under Visual elements. You can find details on how to set it up .

HTML loader - replaced by the element

Enable Postmark on new Canvas apps via the flow seen under .

You can now include app-wide settings here that can be easily managed from the front-end (e.g. single field or a picklist). For more information on how to use these, please read our documentation .

The previous Terms & Conditions and Privacy Policy pages have been deprecated. The content from both of these pages has been consolidated into a single

We've made some minor design updates to the to better align with the design of the marketing and index pages.

Page Flair Group This includes a collapsible image banner, title, description, and toggle tabs. This group should be used when you want to further customize a page.

Block Title Group Most blocks will now come with a that includes a title, dropdown, toggle tabs, description text, sort dropdown, filters, and a new button. This group should be used when you need to add a title group above a section of content.

This Canvas update comes with host of new features as well as a full redesign of the admin portal. Be sure to check out the admin portal overview in the .

You can now create beautiful HTML marketing pages directly within the admin portal using the new !

We have changed the way you add new Bubble pages to your application. You can now use the new to add new Bubble pages & blocks directly within your editor.

documentation
here
View more details
View more details
View more details
here
here
legal page.
log in page
page-level group
title group
Canvas Page Builder
View more details
here
Loading screen
Getting Started section
Canvas Extension
Emails & Alerts
Learn more
Easily manage app-wide configurations
Example of updating a single field
Example of managing a simple picklist that is used throughout the app