Attributes
Attributes are characteristics of items that can help you share additional information about an item.
Main features:
- specify additional characteristics of an item
- link items to events and conditions
Examples of attributes
Item type | Attribute name | Attribute value |
---|---|---|
Game keys | Game type | New, Early access, Coming Soon, Special |
Genre | Action, Adventures, Casual, Simulator, Strategy, RPG | |
Virtual items | Quality | Epic, Legendary, Common |
Class | Warrior, Paladin, Hunter, Shaman, Druid | |
Virtual currency | Event | New year |
Quest | Completing quest 1, Completing quest 2 |
Prerequisites
- Create your Xsolla Publisher Account.
- Open your project.
- Open Project settings > Integration settings and make sure that the Integrate
Commerce API toggle is set to On.
How to get it
Set up attributes
Every attribute has the following parameters:
External ID — a unique attribute identifier.- Name (specified for every language used in a project).
- List of values.
To create and set up attributes, you can:
Configuration via Publisher Account
- Go to Store > Catalog management.

- Click Configure in the Attributes section.

- Click Create attribute.

- Specify the
External ID and name of the attribute.
- Click Save and continue.
- Specify all necessary values for the created attribute. For every value, specify the
External ID . To add more values, click +.
- Click Finish.
Note
The number of attributes in the project is unlimited.
Configuration via API calls
Use API calls from the
Notice
If you delete the attribute, all its values and connections with items will be lost. You can’t restore the deleted attribute and its data.
Configure attribute values
Every attribute value has the following parameters:
- external_id of a parent attribute
- external_id of a value
- name (specified for every language used in the project)
To create and set up attribute values, you can:
Configuration via Publisher Account
- Go to Store > Catalog management.

- Click Configure in the Attributes section.

- Select a required attribute in the list of attributes.
- Open the Values tab and click Create value.

- Specify the External ID and name for the value.
- Click Save changes.
Note
You can’t specify more than 20 values for an attribute. Contact your Account Manager to change this limit.
Configuration via API calls
Use API calls from the
Notice
If you delete a value, all its connections with items will be lost. You can’t restore this data.
Configure attributes for item
To add attributes for items, you can:
Configuration via Publisher Account
To add an attribute for an item:
- Go to Store.
- Open a section with the required item type:
- Virtual items
- Virtual currency
- Game keys
- Bundles
- Create a new item or edit the existing one.
- While filling in the general information about the item, select a previously created attribute in the Attribute section.
- In the Value field that appears, select the identifier that corresponds to the required attribute value.
Note
You can’t specify more than 6 values of the same attribute for one item. Contact your Account Manager to change this limit.
Configuration via API methods
Pass an array of objects with identifiers and values of attributes that you want to link to the
Copy
- http
"attributes": [
{
"external_id": "craft-materials",
"values": [
{
"external_id": "steel",
},
{
"external_id": "leather",
},
...
]
Note
When you receive an item via API calls, you will get the list of attributes and their values connected to an item.
Was this article helpful?
Thank you for your feedback!
We'll review your message and use it to help us improve your experience.