Catalog entry properties

  • Updated

catalog entry properties

Basic info properties

The basic info properties area provides an overview of catalog entry information. Much of it is created automatically and rarely needs to be changed, unless you manually create catalog entries. Change appears next to some properties. Click it to edit a property value.

  • Display name. Name on the content display page.
  • Name. Name in catalog item list.
  • Name in URL. URL automatically created, based on name and place in the navigation; whether it is visible in site links depends on implementation.
  • SEO URL. Automatically created based on Name; whether it is visible in site links depends on implementation.
  • Code. Product code/identification key, often provided by an external system.
  • Market. Markets where the item is available. By default, a product or variant is available in all markets.
  • Visible to. Which users and groups can see the item. By default, catalog content is publicly visible and editable by CommerceAdmins group members.
  • Languages. The content is available in the displayed languages. The active language is not underlined.
  • ID, Type. The ID set by the system; the content type upon which the item is based.


The Content tab properties depend on the product or variant.

Image: Content tab

Descriptions can include formatted text, images, and links, using a rich-text editor.

The Links dialog includes the following Customized Commerce-specific properties:

  • Catalog content. Lets you assign a link to any catalog entity, such as a catalog, category, product, or variant. For example, if you link to a category, when that link is clicked, a page appears listing all products in that category.
  • Marketing content. Lets you assign a link to any marketing campaign or promotion.

Image: Links dialog

Belongs To

The Belongs To tab displays categories and products, packages and bundles to which a product or variant belongs. For example, a variant belongs to a product and has a primary category. Also, an item may be part of a Weekly specials category and a Spring package category, as the following image shows. See also: Working with categories.

Image: Belongs To tab

Pricing (for variants)

The Edit Prices view lets you view and update pricing for packages and variants. The view displays a compact list of prices, which can be filtered by market or customer group. Market filtering displays both active and inactive markets.

The same item can be available in several markets. For each market, you can define multiple currencies and establish a different price for each one. If you enter no value for any currency, users will not be able to place an order for the item in that currency.

For each product or variant, you can define the following pricing information.

  • market
  • price
  • valid date range
  • sale type
  • sale code
  • minimum quantity

In many cases, pricing information comes from an external system, which may prohibit modifications in Optimizely Customized Commerce.

Price changes are immediately available on the website. They are not part of a product's publishing workflow.

Viewing prices

  1. In the catalog tree, select a category or product.
  2. From the view selector in the upper right corner, click Pricing.

    Image: Edit prices

  3. If desired, use the Customer Group and Market filters to make it easier to find pricing information.

    Only packages or variants with a price appear on the list.

Adding and editing prices

Follow the steps in Viewing prices to access the Edit Prices view. From there, you can complete these tasks.

  • To adjust a product's or variant's price information, modify these fields.
    • Market. Associate the price with a market.
    • Price. The item's price and currency for that market.

      The list of currencies is determined by those available for the selected market.

    • Valid. The time interval when this price is available.
      • To create a future price change.
        1. Select the item.
        2. Click Duplicate from the context menu.
        3. Change the new item's pricing information.
        4. Set the new available dates.
    • Sale Type. Make the price available to All Customers, a specific Customer, or a Customer Price Group. With the last option, you can create tiered pricing (also known as differentiated pricing).
    • Sale Code. Use this field to assign a price to a specific customer group. For example, create a new price, select Customer Price Group as its Sale Type, then insert the customer group name into the Code field.
    • Min. quantity. The minimum number of units that must be purchased to get the listed price.

      Use this feature to provide a bulk rate. For example if a customer purchases 10 or more, the cost is $50.00 each. If fewer than 10, $60.00 each.

      Image: Adding prices

  • From a product's or variant's context menu:
    • click Duplicate to create a copy of price information, which you can then modify to create a new pricing setup.
    • click Delete to remove a set of price information.

      You cannot undo the deletion of price information.

Setting customer group pricing

Use Customer Groups to set permissions and create targeted marketing campaigns.

To create a customer group price:

  1. Follow the steps in Viewing prices to access the Edit Prices view.
  2. In the Edit Prices view, click Add Price.
  3. Click Customer Price Group.
  4. Select the customer group to which the price applies.

Inventory (for variants)

Inventory information is often transferred from an external system, so you rarely need to change it. Sometimes you cannot edit it. On other sites, you can update quantities but the other information is read-only.

Inventory screen

Image: Inventory screen

When first viewing a variant's inventory information, you have access to the following information.

  • Min. quantity. If desired, set a minimum number of this variant that a customer must buy. If a customer adds fewer than this to a cart, the quantity will be increased to the minimum during cart validation.
  • Max. quantity. If desired, set a maximum number of this variant that a customer can buy. If a customer adds more than this to a cart, the quantity will be decreased to the maximum during cart validation.
  • Weight. Enter the variant’s weight in your system's weight unit. Weight is used to calculate shipping costs.
  • Shipping Dimensions
    • Length, Height, Width. Enter the variant’s length, height and weight in your system's length unit. These properties may be used to calculate shipping costs.
  • Tracked. If this variant is Tracked, the inventory system is checked for sufficient quantity when someone orders the item. If the variant is not Tracked, orders are filled without referencing the inventory quantity.

    Note that each inventory for this variant also has an Is Tracked field. The inventory check is made only if both values are true.

Edit inventory screen

Image: Edit inventory screen

You can view (and possibly edit) the following inventory properties for a product or variant.

  • Location. The physical stock location of the inventory, as defined in warehouse settings.
  • Code. Product code/identification key; often provided by an external system. Read only.
  • In Stock. The quantity of in-stock items for an inventory.
  • Backorder Availability. If customers can backorder this item, enter the first date when it is possible.
  • Backorder Quantity. The quantity of this item which may be backordered.
  • Preorder Availability. If customers can preorder this item, enter the first date when it is possible.
  • Preorder Quantity. The quantity of this item which may be preordered.
  • Reorder Min. Quantity. The in-stock quantity level at which items should be reordered. For example, when an inventory location has three or fewer items, it is time to order more.

    The Low Stock Report uses this value to inform a merchandiser that it is time to reorder. Also, a custom implementation could send email or another alert when in-stock quantity reaches this amount.

  • Is Tracked. If selected, shoppers can only complete orders for this product/variant if you provide inventory information from the Inventory Locations. If Is Tracked is not selected, orders can be placed without inventory amounts.

    Each variant also has an Is Tracked field. The inventory check is made only if the variant-level Is Tracked field and this one are true.

  • Purchase Availability. First date and time when this item can be sold from this inventory.

Variants (for products)

A variant is a version of a catalog entry with specific characteristics, such as price, size, and color. You can perform most of the tasks on a variant that you can perform on a catalog entry. See also: Working with catalog entries.


Use the Assets tab to link a catalog entry to a media file, such as an image or a document. For example, you want to assign a picture to a catalog entry to accompany its website description.

To add a media file, open the Assets tab, then drag the file from the Media tab to the Assets tab. Or, click Add Media and select the file.

Image: Add Media button

When assigning media files to a variant, you can assign them to a group, such as Banner. You can then sort the files by clicking the Group column header.

To rearrange items in the list, click Move Up or Move Down from the context menu.

On the sample site, the item assigned to the default group at the top of the list is used for the main display.

Related entries

The Related Entries tab lists catalog entries related to the current one. Typical relationship types are cross-sell and upsell. The types are set up by your developer during implementation.

Here is a typical cross-sell scenario: If a site customer views a page with a specific television model, a section of that page is titled ”People who bought this also bought". That section shows HDMI cables and wall mounts that fit that TV model.

To set up those relations, an Optimizely Customized Commerce merchandiser goes to the television, clicks its Related Entries tabs, and adds suitable cables and wall mounts using the type cross-sell.

Image: Related Entries tab


Settings is a default tab with several built-in, date-related properties that you rarely need to change.