Product and Variation Properties: Overview of Methods

Products and variations have properties such as color, size, material, brand, and others. These properties help customers find and select products on the site.

In Bitrix24, properties can be configured.

  • Make them common for all products. Such properties are available for all products in the catalog; for example, the "Brand" property can be specified for all products.

  • Bind them to product sections. For instance, the "Material" property may only be available for the "Clothing" section, while the "Diagonal" property may only be available for the "Televisions" section.

Quick navigation: all methods and events

User documentation: Product and Variation Properties

Property Types

Each property has a type: String, List, Number, Employee Binding, and others. A complete list of property types is described in the fields parameter of the catalog.productProperty.add method. To work with values of the List type properties, you can use the catalog.productPropertyEnum.* methods.

The type is set when creating the property and cannot be changed.

Linking Product Properties with Other Objects

Trade Catalog. Product properties must be linked to a specific trade catalog. You can obtain the identifiers of available trade catalogs using the catalog.catalog.list method.

Currencies. In the Money type property, you specify the amount and currency. You can work with currencies through the crm.currency.* methods.

User. In the product or variation property, you can set a binding to an employee. You can obtain the user identifier using the user.get and user.search methods.

CRM. The Binding to CRM Elements type property links products with CRM objects: leads, deals, SPAs, contacts, and companies. In products, this property is displayed as a link to the CRM object.

Universal Lists. Products can be linked to list elements through the Binding to Elements property in list form. You can work with lists using the list.* methods.

Files. The File type property allows you to upload and store files in the product. Files do not receive identifiers in the Drive module, so Drive methods are not applicable. For more details, read the article How to Upload Files.

User Documentation

Overview of Methods

Scope: catalog

Who can execute the method: any user

Method

Description

catalog.productProperty.add

Adds a product or variation property

catalog.productProperty.update

Updates the fields of a product or variation property

catalog.productProperty.get

Returns the values of the fields of a product or variation property

catalog.productProperty.list

Returns a list of product or variation properties

catalog.productProperty.delete

Deletes a product or variation property

catalog.productProperty.getFields

Returns the fields of a product or variation property