Category templates
Define the storefront view file and extra CSS of categories per tree, add and edit templates.
Category templates screen is where you define which view file categories are displayed with on the storefront (web store) and which extra CSS is added to this view. Templates are stored per category tree. Templates defined here can be selected in the Template field in the details of categories in the same tree; assigning a template to a category is done there. This screen is generally used by the catalog and e-commerce team managing the storefront design.
Accessing the screen
This screen does not have a separate item in the left menu. Open it as follows:
- Go to the PIM & Catalog › Categories screen.
- Press the Templates button at the top right of the page.
The screen opens with the category tree currently selected in the Categories screen. If no tree is selected in the Categories screen, the Templates button is inactive.
If you cannot open the screen, your account does not have permission to view categories.
Screen sections
- Title — Category templates and the subtitle The storefront view file and extra CSS used by categories. On the right, if you have edit permission, the Add template button.
- Selection area — Category tree selector, Search box, and the number of templates listed on the right (e.g., "4 templates").
- List — templates of the selected tree.
Filtering and searching
| Field | Purpose | Tip |
|---|---|---|
| Category tree | Selects which tree's templates are listed. | If you opened the screen directly from the address bar and no tree is specified, the first tree in the list is selected. Changing the tree refreshes the list immediately. |
| Search | Filters the list by template name, view file, or template id. | Filters instantly as you type; case insensitive and matches any part of the text. |
The selected tree and search text are written to the address bar. When you refresh the page or share the link, the same view opens.
List
| Column | Meaning |
|---|---|
| Template name | The name of the template; this name appears in the Template field in category details. |
| View file | The view file used by the storefront to render the category page. If no file is linked, shows —. |
| Order | The order value of the template. If empty, shows —. |
| Extra CSS | Shows Yes if extra CSS is written for the template, otherwise —. To see the CSS itself, open the template in the edit window. |
| Template id | The system id of the template. Cannot be changed. |
| Actions | If you have edit permission, a pencil icon (Edit); otherwise empty. |
The list is a single page; no pagination or column settings.
Actions
Adding a template
Used to add a new template to the selected tree.
- Select the tree you want to add the template to in the Category tree selector.
- Press the Add template button.
- Fill in the Template name field in the opened window.
- Press the Save button.
If the save is successful, the window closes, a Saved notification appears, and the list refreshes. The new template is created with only the name; view file, order, and extra CSS can be entered later from the edit window.
- Save is inactive if the name is empty (including only spaces).
- The Add template button is not visible if you lack edit permission; it is inactive if no tree is selected.
Editing a template
- Press the pencil icon on the template's row in the list. The window opens with the template's name in the title.
- Update the fields you want to change (fields described in the table below).
- Press the Save button.
While saving, the button shows Saving…. If successful, the window closes, a Saved notification appears, and the list refreshes. Save is inactive if Template name is empty. No confirmation is asked before saving.
| Field | Required | Description / rule |
|---|---|---|
| Template id | — | Display only, cannot be changed. |
| Template name | Yes | Cannot be left empty. |
| Order | No | Enter only integers; the screen does not validate non-numeric values. Leaving empty removes the order value. |
| View file | No | Select one of the view files defined in the system. If none selected, the box shows Select. |
| Category tree | No | The tree the template belongs to. If you select another tree and save, the template is linked to that tree and may no longer appear in the list of the tree selected above. |
| Extra CSS | No | Description below the field: "Added to categories using this template on the storefront." Enter CSS as is in the text box; leaving empty removes extra CSS. |
Extra CSS is applied directly to the storefront and affects all categories using this template. Check which categories use this template before saving changes.
Closing without saving
If you made changes in the add or edit window and then press Cancel, Close, or click outside the window, a Changes not saved confirmation appears ("Unsaved changes will be lost. Continue?"). In the add window, this confirmation appears only if you typed something in the Template name field:
- Discard changes — changes are discarded and the window closes.
- Cancel — confirmation closes and you continue editing.
If you try to navigate away via menu or browser back button with unsaved changes, the same confirmation appears. If you try to close the tab or refresh the page, your browser shows its own warning.
Deleting a template
Template deletion is not available on this screen.
Common situations
List is empty, shows "No records found" and "No templates defined for this tree." No templates have been defined for the selected category tree yet. Make sure you selected the correct tree or create a new template with Add template.
Shows "No templates matching the search." The search text does not match any template name, view file, or id. Clear the Search box.
The Add template button or pencil icon is not visible. Your account does not have permission to edit categories. You can view the list but cannot make changes.
After saving, the template disappeared from the list. If you changed the Category tree field in the edit window, the template is linked to that tree. Select the new tree in the Category tree selector above and check.
"Something went wrong" notification appeared while saving. Changes were not saved, the window remains open. Check the details in the notification and try again; if the problem persists, contact your system administrator.
List appears to be loading continuously. The list does not load without a selected category tree. If the Category tree selector shows Select a category tree and there are no trees in the list, no category tree has been defined yet; first check the existence of trees in the Categories screen.
Shows "PIM service not configured." Your environment's PIM connection is not established. Contact your system administrator.