Catalog meta-classes and meta-fields

This topic is intended for administrators and developers with administration access rights in Optimizely.

You can extend the metadata of catalogCommerce: a top-level container for catalog entries such as categories, products, and variants (SKUs). items and order forms. For example, if you create a meta-class called Wine, add meta-fields that are characteristic for wine, such as color, taste, vintage, and maturity.

You can also define single and multiple dictionary types of value selectors with options. This results in a drop-down selector where editors can select values for product properties, such as fabric types for clothing, or genre for media.

After you create meta-classes and meta-fields in Commerce ManagerOne of several main user interfaces in Optimizely Commerce. This UI area, available from the top menu after logging in, provides screens for managing markets, customers, catalog, orders, and so on. You can manage the information on some Commerce Manager screens in other, newer user interfaces. Where possible, we recommend using the newer ones., others can use them when working with catalog entries in the product catalog.

Creating a catalog meta-class

  1. Open Commerce ManagerOne of several main user interfaces in Optimizely Commerce. This UI area, available from the top menu after logging in, provides screens for managing markets, customers, catalog, orders, and so on. You can manage the information on some Commerce Manager screens in other, newer user interfaces. Where possible, we recommend using the newer ones. and go to Administration > Catalog System > Meta Classes. The Meta Classes page appears.
  2. Select Create New > New Meta Class and fill in the fields.

    Image: Selecting New Meta Class

    • Name. Enter the name of the meta-class used in your code. Spaces are not allowed.
    • Friendly Name. Enter the name of the meta-class displayed for practical use in Catalog Management.
    • Description. Enter a description of the meta-class.
    • Object Type. Select the type of catalog entity to which this class applies: Catalog Node or Catalog Entry.
  3. Click OK. The newly created meta-class appears in the Type drop-down list.

If you select the meta-class, you see available meta-fields listed but with none selected.

Creating a catalog meta-field

  1. Go to Administration > Catalog System > Meta Fields. The Meta Fields page appears.
  2. Click New Meta Field. The Meta Field edit page appears.

    Image: Selecting New Meta Field

    You can also select Create New > New Meta Field on the Meta Classes page.

  3. Enter Meta Fields details.

    Image: Entering Meta Fields details

    • Name. Enter a system name without spaces or special characters (such as NumberMegapixels).
    • Friendly Name. Enter a user-friendly name seen by users on the back and front-end (such as Number of Megapixels).
    • Description. Enter information about the meta-field.
    • Type. The drop-down list shows the following field types.
      • datetime
      • decimal
      • float
      • money
      • Integer
      • Boolean
      • Date
      • Email
      • URL
      • Short String
      • Long String
      • Long Html String
      • String Dictionary
      • File
      • Image File
      • Dictionary (single and multiple line dictionary type option selector)
      • Supports Multiple Languages. Select if the meta-field can appear in two or more languages.
      • Use in comparing. Select to compare items (only works if you have compare functionality on the front-end site).
      • Allow Null Values. Allows a null value for this field.
    • Search Properties. Depending on the data field type selected, you may have the option to set the search properties of the data field. The options are:
  4. Click OK to save your changes. The newly added meta-fields appear in the meta-fields list.

If newly created meta-fields are not immediately visible, go to the next page or set the Page Size to display more entries.

Applying meta-fields to a meta-class

  1. Go to Administration > Catalog System > Meta Classes. The Meta Classes page appears.
  2. Select Element > Catalog Entry.
  3. Select the desired meta-class from the Type drop-down list. The Name, Friendly Name, and Description fields are populated with default values.
  4. Apply a meta-field to a meta-class by selecting the check box next to the meta-field. If you want to sort the order of the meta-fields in the catalog entry, enter a number into the Sort field.

    Image: Defining entry order

  5. Click OK.