Upload a theme in Theme Manager

note

There are 2 steps to upload a theme in Theme Manager, first you will need to package your theme in the toolkit, then you will need to log into your marketplace and upload the theme in Theme Manager.

Create a theme package in the toolkit

After you customize and view your theme in your development environment, you can package the current theme as a .zip file, then upload it to the . You can use the to view different versions of the theme, manage it, and preview it in your production environment. You can ensure that the theme is stable before you publish it to your production environment.

To create the .zip file, you must use the package command. This command operates on the current default theme. If the theme you want to package is not the current default, you must first Switch between themes to the correct theme.

To package a theme

1. Open a command-line window.

2. Go to your workspace folder.

3. Type sfb-toolkit package and press Enter. The tool asks whether you want to include translations in the package.

4. Choose y to include translations, or N to omit them, and press Enter.

   If your theme is based on Plaza (that is, if it uses components), the tool asks whether to include the Theme Editor layout editor settings. Choose y to include them, or N to use the defaults, and press Enter.

   Wait for the command to finish.

The theme is generated as a .zip file in your /theme-zips folder.

Upload the theme in Theme Manager

An uploaded theme is not automatically published. You can use the to view different versions of the theme, manage it, and preview it in your production environment. You can ensure that the theme is stable before you publish it to your production environment.

important

To upload your theme, you must have the Marketplace Manager role.

To upload a theme:

1. Log in to the marketplace in your production environment as .

2. Go to *Manage > Marketplace >• . The page opens.

3. In the My Themes section, click Upload Theme. The Upload Theme dialog appears.

4. Click Choose File in the Upload Theme field.

5. Select the .zip file that was added to your /theme-zips folder. The file name includes the theme name, date, and time to identify the theme. For example, mytheme__2018-09-05_13.39.51.zip.

6. Enter a name for your theme in the Theme Name field.

7. Click Upload. A confirmation message appears, and the theme appears in a new row in the My Themes section. The theme .zip file takes time to process and is not ready to publish immediately. Additionally, the theme is not published when it finishes processing.

   If your theme was not uploaded successfully, a Processing Failed message appears in the Actions column. Click Processing Failed to view error messages.

After the theme has been uploaded, you can use it with other Theme Manager features. If it is based on the Plaza theme, you can also launch it in the Theme Editor to make further changes (see Work with the Theme Editor).