Adding properties to Commerce entities

Current version: 9.3

Sitecore XC Business Tools let you customize the information displayed for any Commerce entities. You can add new properties to any of the following Commerce entities:

  • Catalogs

  • Categories

  • Sellable items

  • Inventory sets

  • Price books

  • Price cards

  • Promotion books

  • Promotions

  • Customers

  • Orders

To add new properties to a Commerce entity, you create a new child view for the entity. If you want to apply the new set of properties to more than one Commerce entity, you convert the new child view to a Composer template on the Composer dashboard to make it available to other Commerce entities.

You can apply a set of custom properties to one instance of a specific Commerce entity, a subset of Commerce sellable items, or to all Commerce entity of a certain type (for example, all catalogs).

Note

When you add custom properties to Commerce entities (for example catalogs, categories, and sellable items), and you add custom properties to the index to make them searchable, you increase the number of fields that the system indexes for Search. If you have deployed your Sitecore XC solution to the Azure App service, you cannot add more than 300 custom fields, due to limitations with Azure Search.

Note

You must be assigned to the Commerce Administrator role to access this functionality.

Supported data types

When you add a new property to a Commerce entity, you must specify a data type for the property, that is, the kind of value expected for the property, such as a string or a decimal, for example. Depending on the data type you select, you can further define constraints for values permitted for the property.

The Business Tools allows you to define the following data types for your custom entity properties:

  • String

  • DateTimeOffSet

  • Decimal

  • Integer

  • Boolean

Do you have some feedback for us?

If you have suggestions for improving this article,