How do I create a theme for an account using the Theme Editor?

As an admin, you can use the Theme Editor to create custom themes for your institution. Themes are created from existing Canvas templates. Any theme applied to the account also applies to all subaccounts, though the Theme Editor can also be used to create themes for individual subaccounts. Once you have created and saved a theme, you can apply the theme to your account at any time. You can also create new themes based on previous themes. Learn how to manage saved themes.

View a video about the Theme Editor.

Theme Inheritance

Custom branding is hosted at the account level, and by default, sub-accounts and their associated courses inherit account branding. However, you can enable sub-accounts to use the Theme Editor; any elements that are not specifically changed will still be inherited by the account level.

User enrollments are associated at the account level and course enrollments are associated at the sub-account level. An enrollment is created when a user and a course are joined together. If a user is not enrolled in any courses, the Dashboard displays branding for the account. This algorithm also relates to pages not associated with a course including user account and settings, Calendar, and Conversations. User data is always hosted at the account level, which is why they cannot inherit sub-account branding.

If a user is enrolled in a course in the account, the Dashboard displays the branding for the account. If a user is enrolled in a course within a sub-account, the Dashboard displays the branding for the sub-account. If a user is enrolled in courses within multiple sub-accounts, or if one of the courses is in the account, the Dashboard displays the branding for the account.

Theme Editor Components

For details about the Theme Editor components, including components that display on Canvas apps, please view the Canvas Theme Editor Components resource document. For help with image templates, view the Canvas Theme Editor Image Templates resource document. Logos, images, and watermarks are not visible for users who enable the High Contrast Styles feature option in user settings.

CSS/JS Files

Custom cascading style sheets (CSS) or JavaScript (JS) files are not required, but override files are also supported in the Theme Editor. CSS/JS file functionality must be enabled by your Customer Success Manager. Before uploading custom CSS or JS files, please be aware of the associated risks, as custom files may cause accessibility issues or conflicts with future Canvas updates. Learn more about custom CSS/JS restrictions.

 

Notes:

  • The Theme Editor is not available for Free-For-Teacher accounts.
  • If you are a subaccount admin and the Themes link is not visible in Account Navigation, Themes has not been enabled for sub-accounts. If the CSS/JS Upload tab is not visible, file uploads have not been enabled for sub-accounts.
  • To preview Theme Editor branding, you need to turn off High Contrast UI.
  • By default, consortium child accounts inherit the theme applied in the parent account. However, a consortium child account can create a new theme for the child account.

Open Account

Open Account

In Global Navigation, click the Admin link [1], then click the name of the account [2].

Open Themes

Open Theme Editor

In Account Navigation, click the Themes link.

Note: If sub-account themes have been enabled, each sub-account also includes a Themes link. To open the Theme Editor for a sub-account, click the Sub-Accounts link to locate and open the sub-account, then click the sub-account's Themes link.

Open Theme Template

If you do not yet have a Canvas theme for your account, use a template to create a new theme. You can choose from the Default Canvas template, a minimalist template, and a State U. template. If your Customer Success Manager has enabled the K12-specific feature option, the K12 Theme also appears as a template.

To create a new theme, hover over a template and click the Open in Theme Editor button [1], or click the Add Theme button [2] and select a template from the list.

Open Saved Theme

Open Saved Theme

If you previously created and saved a theme, you can edit saved themes at any time. Saved themes display in the My Themes section. To open a saved theme, hover over the name of the theme and click the Open in Theme Editor button [1].

To create a new theme based on a saved theme, click the Add Theme button [2] and select the name of the saved theme from the list [3]. This option helps you avoid overwriting your previously saved theme.

View Theme Editor

The Theme Editor displays a sample page to preview your custom branding. These components will change with the colors and branding that you add using the Theme Editor.

View CSS/JS Upload Tab

View CSS/JS Upload Tab

If custom cascading style sheets (CSS) or JavaScript (JS) override files have been enabled for your account, the Theme Editor sidebar displays an Edit tab [1] and an Upload tab [2]. The Theme Editor defaults to the Edit tab and shows all the Theme Editor components. The Upload tab allows you to upload custom files.

Locate Components

Locate Components

The Theme Editor has four component groups: Global Branding, Global Navigation, Watermarks & Other Images, and Login Screen. By default, the Theme Editor sidebar displays the Global Branding group.

Locate the component you want to customize. You can expand and collapse groups by clicking the arrow icon next to the group heading.

Select Color via CSS

Select Color via CSS

The default value for each component is faded in the text field.

To specify a color component, locate the component text field and enter a new CSS color. You can enter colors via hex code, RGB value, or valid color name.

Note: Entered colors will convert and display as hex codes.

Select Color via Color Selector

Select Color via Color Selector

In browsers that support native color inputs, the color selector can be used to choose a value. Locate the component and click the color box. The color selector will appear in a new window.

Select Color

Select Color

Select a color in the color selector window [1]. Once a color is selected, the component displays the new color in the box [2]. The component's hex color also updates with the new color value.

Add Images

Add Images

For components that require images, locate the component and click the Select Image link. The image description will include supported file types.

Preview Theme

Preview Theme

To preview your theme, click the Preview Your Changes button.

Canvas will generate the preview of the components based on your template changes. If necessary, make additional changes and preview your theme again.

Save Theme

Save Theme

Once you are satisfied with your template changes, save your theme by clicking the Save Theme button.

Create Theme Name

Create Theme Name

If you modified a theme from a template, the Theme Editor creates a copy of the theme. Templates cannot be edited directly. In the Theme Name field [1], enter a name for your theme. Click the Save Theme button [2].

Note: If you edited a previously saved theme, saving the theme overwrites the previous version of the theme and uses the same theme name.

Apply Theme

Apply Theme

To apply your theme to your account, click the Apply theme button [1].

To exit the theme and return to the Themes page, click the Exit button [2]. You can open the theme and apply it to your account at any time.

Verify Theme Application

To apply the theme to your entire account, click the OK button [1]. To return to the Theme Editor, click the Cancel button [2].

Note: If your account allows subaccounts to customize their own themes, any applicable changes you made will also filter down to any associated sub-accounts. Canvas shows the status of your Theme Editor updates; when the process for each subaccount is complete, the subaccount disappears from the progress window. When all subaccounts have been updated, the Theme Editor redirects back to the Themes page.