Reference information - categoryEdit on GitHub
This topic contains the reference information for working with categories in the Category section.
In the Category section, you see the following:
- Category key, category name, and the parent category to which a specific one is assigned
- Identifiers for Active, Visible and Searchable
- Template type
- Actions that you can do on a specific category
Category page template types
When you create or update the categories, you select a template according to which your category (and the assigned to it products) is going to be displayed in your online store.
The following templates are used to set up your category look:
Catalog (default) Select this template if you want to display all product pages linked to the selected category. The product pages include the general product description, a price, an image, and a clickable View button that will redirect you to the product details page. See how the Catalog template looks on Yves.
Catalog+CMS Block Select this template if you want to show all product pages assigned to the selected category and a CMS Block. Depending on your design requirements, you need to set a specific CMS block and to specify where it should be displayed: top, middle, or bottom. See Content Management topics for more information.
See how the Catalog+CMS Block template looks on Yves.
The category is in the catalog, and two CMS blocks are now displayed on the page: Tackle Your To-Do’s and Build a Space That Spurs Creativity in the example).
CMS Block Select this template if you want to display only a specific CMS block on the category page. In this case, choose a position of the CMS block on the page. See how the CMS Block template looks on Yves.
Instead of navigating you to the catalog view, once such a category is selected you see the CMS block.
- Sub Category grid Select if you want to create a multilevel category structure. Here you can assign an image to each subcategory. See how the Sub Category grid template looks on Yves.
A template with slots
To use such a template, the Templates & Slots feature should be integrated into your project.
Select such a template if you want this category page to have slots. Slots can embed content from CMS Blocks and technology partner integrations. See Templates & Slots Feature Overview for more details.
Create and edit category page attributes
The following table describes the attributes you use when creating or updating a category.
|Category key||The value you enter can later be used to automatically assign products and CMS blocks to your category through the import.|
|Active||Defines if the category is in the active state and is visible in the shop application.|
|Visible in the category tree||Defines if the category is shown in the menu in the shop application.|
|Allow to search for this category||Defines if the category is available in search results.|
|Parent||A drop-down list with categories under which your category will be displayed in the hierarchical tree. It means that the category you are currently creating will be nested under the particular category you select. Only one value can be selected.|
|Additional Parents||A drop-down list with categories under which you can locate your specific category in addition to the Parent. Several values can be selected.|
|Template||A drop-down list with templates that you select to define the look of your category in the online store. (See Category Page Template Types)|
|Translations||In this section you define the meta details. Their purpose is to improve search ranking in the search engines.|
|Translations: Name||The name that serves as an ID for the back end.
The name that will be displayed to the customer on the shop website is rendered with the help of the category key.
|Translations: Meta Title||The title that describes the category.|
|Translations: Meta Description||The description of the category. The text you enter as meta information will not be displayed on the website to the customer but will be located in the HTML code of the category page.|
|Translations: Meta Keywords||The keywords that are suitable for the category.|
|If you select the CMS-related template (either Catalog+CMS Block, or CMS block), the following additional attributes appear:|
|CMS Blocks: top||Defines a CMS Block for a top position. Several values can be selected.|
|CMS Blocks: middle||Defines a CMS Block for a middle position. Several values can be selected.|
|CMS Blocks: bottom||Defines a CMS Block for a bottom position. Several values can be selected.|
|Image Set Name||Defines the name of the image set, e.g. Default.|
|Small||URL of the small version of the image.|
|Large||URL of the large version of the image.|
|Sort Order||A numeric identifier of the image in the order of other images of an image set. This defines the order in which the images are shown in the back end and front end. The order starts from “0”.|
For submitting the form