Product and Variation Properties: Overview of Methods
If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.
Products and variations have properties such as color, size, material, brand, and others. These properties help customers find and select products on the site.
Properties can be made common for all products or linked to catalog sections. For example, the "Brand" property can be available for all products, while the "Material" property can be available only in the "Clothing" section.
Quick navigation: all methods
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.
Relationship 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
How to Start
- Get the trade catalog identifier using catalog.catalog.list
- Create a property using catalog.productProperty.add
- If the property should be available only in specific sections, configure the binding using catalog.productPropertySection.*
- If the property has the List type, add values using catalog.productPropertyEnum.*
- Use the property code in product, service, parent product, or variation methods
Overview of Methods
Scope:
catalogWho can execute the method: depending on the method
|
Method |
Description |
|
Adds a product or variation property |
|
|
Updates the fields of a product or variation property |
|
|
Returns the values of the fields of a product or variation property |
|
|
Returns a list of product or variation properties |
|
|
Deletes a product or variation property |
|
|
Returns the fields of a product or variation property |