PrintNowPrintNowDocs
Themes

Site Themes

Create, edit, clone, and apply storefront themes that control the HTML, CSS, JavaScript, and images used on your customer-facing site.

Site Themes is where you manage the visual presentation layer of your storefront. Each theme is a folder of files -- HTML templates, CSS stylesheets, JavaScript, images, and ASP.NET master pages -- that together define how your storefront looks and behaves. You can maintain multiple themes, clone an existing theme to experiment with changes, and apply any theme to your storefront with a single click.

New themes are initialized from a default template that includes a starter storefront.css, default.skin, and a set of master pages. From there, you can customize every aspect of the storefront's appearance through the built-in code editor.

View Site Themes

  1. From your Unified Admin, go to Site Themes.
  2. The theme list displays all themes in a paginated grid sorted alphabetically by name.
  3. The In Use column shows a checkbox indicating which theme is currently applied to your storefront. Only one theme can be active at a time.
  4. Click Add Theme to create a new theme from the default template.

Theme List Columns

ColumnDescription
Theme NameDisplay name of the theme. Must be unique across all themes. The name "default" is reserved and cannot be used.
In UseCheckbox indicating whether this theme is currently applied to the storefront. Only one theme is active at a time.
ActionMenu with Apply, Clone, Edit, Rename, and Delete options.

Theme Actions

ActionDescription
ApplySets this theme as the active theme for your storefront. The previous theme is immediately deactivated and the new theme takes effect on the next page load. The ThemeMap record is updated (or created) to link the storefront to this theme.
CloneCreates a complete copy of the theme, including all files and subfolders. The clone is named {original-name}-copy (or {original-name}-copy-1, -copy-2, etc., if a copy already exists). Use this to safely experiment without modifying a live theme.
EditOpens the built-in file manager where you can browse, create, edit, and manage all files within the theme folder.
RenameOpens a dialog to change the theme name. The theme folder on disk is also renamed to match. The name must be unique and cannot be "default".
DeletePermanently deletes the theme, its folder on disk, and any storefront-to-theme mappings. This action cannot be undone. A confirmation dialog appears before deletion.

Edit Theme (File Manager)

Clicking Edit on a theme opens the file manager, a two-panel interface for managing the theme's file system.

Left Panel: A folder tree showing the directory structure. Click any folder to navigate into it. Only directories are shown in the tree.

Right Panel: The contents of the currently selected folder, displaying each file and subfolder with sortable columns.

File List Columns

ColumnDescription
NameFile or folder name. Click a folder to navigate into it. Click a text-based file (HTML, CSS, JS, XML, etc.) to open it in the code editor.
SizeFile size displayed in human-readable format (B, KB, MB). Blank for folders.
TypeFile type derived from the extension (e.g., "CSS file", "PNG image", "File folder").
Date ModifiedLast modification timestamp (MM/DD/YYYY hh:mm:ss AM/PM).
ActionPer-file menu with Rename and Replace options. Replace is only enabled for image files (PNG, SVG, JPG, JPEG).

File Manager Actions Menu

ActionDescription
New FolderCreates a new subfolder in the current directory. Opens a dialog to enter the folder name.
New FileCreates a new empty file in the current directory. Opens a dialog to enter the file name with extension.
DownloadDownloads the selected files and folders as a ZIP archive. Select items using the checkboxes, then click Download. Use the header checkbox to select all.
DeleteDeletes the selected files and folders. Select items using the checkboxes first. A confirmation dialog appears before deletion.
BackNavigates up one level in the folder hierarchy.

Code Editor

Clicking a text-based file opens a full-screen Monaco code editor dialog. The editor provides syntax highlighting for HTML, CSS, JavaScript, XML, and other text formats.

ElementDescription
File pathDisplayed in the header showing the full relative path of the file being edited.
SaveWrites the current editor content back to the theme file. The file's original encoding (UTF-8, ASCII, etc.) is preserved.
CancelCloses the editor without saving changes.
Fullscreen toggleExpands the editor to fill the entire browser window, or exits fullscreen mode.

Add a New Theme

  1. Click the Add Theme button.
  2. A dialog opens prompting for a theme name.
  3. Enter a unique name and click Save. The name is sanitized (special characters are removed).
  4. PrintNow creates a new theme folder initialized with the default template files (starter CSS, skin, and master pages).
  5. The new theme appears in the list but is not applied until you explicitly click Apply.

Associations

AreaEffect
Storefront appearanceThe applied theme controls all visual aspects of the customer-facing storefront. The StorefrontIdentity resolves the active theme for each request, and the ASP.NET virtual path provider serves files from the theme's folder. Changes to theme files take effect immediately on the next page load.
Master pagesTheme folders contain ASP.NET master pages (.master files) that define the storefront's page layout, header, footer, and navigation structure.
CSS and stylingThe storefront.css file in the theme controls all storefront styling. Additional CSS and JavaScript files can be added to the theme folder and referenced from master pages.
Category templatesCategory page rendering uses templates served from the active theme folder.
Product browser widgetThe product browser control loads its templates from the active theme.
User GroupsUser groups can be assigned a specific theme via the themeid field, allowing different customer segments to see different storefront designs.
OrganizationsOrganizations have a ThemeId field that can override the storefront-level theme for members of that organization.
FTP accessTheme files can also be managed via FTP accounts configured in Domain Tools. This is the recommended approach for large-scale file uploads and downloads.

On this page