Custom Attributes
Custom Attributes let you extend the default data model for Customers, Carts, and Lines with company-specific fields.
Go to Configuration → Company → Custom Attributes in Owner. Use the tabs at the top to switch between the three categories.
The main list shows:
| Column | Description |
|---|---|
| Name & API Name (Slug) | Display name and technical identifier |
| Type | Data format stored in the field |
| Description | Internal notes about the attribute's purpose |
| Actions | Icons to view details, edit, or remove attributes |
Creating a New Attribute
Click + New attribute and fill in:
| Field | Required | Description |
|---|---|---|
| Name | Yes | Label shown in the UI |
| API Name (slug) | Yes | Technical identifier used in integrations and APIs (e.g. loyalty_points) |
| Type | Yes | Data format — see table below |
| Description | No | Internal note explaining the attribute's purpose |
Available Data Types
| Type | Description | Example |
|---|---|---|
| String | Plain text | Customer's occupation |
| Number | Numerical values | Credit score or points |
| Array - String | List of multiple text values | ["VIP", "Eco-friendly"] |
| Array - Number | List of multiple numbers | List of preferred store IDs |
| Boolean | True / False toggle | "Is subscribed to newsletter" |
| Date | Specific calendar day | Birthday or anniversary |
| Date & time | Specific day and exact time | Last activity timestamp |
Marking an Attribute as Personal Data (PII)
Every new attribute has the Contains personal data toggle ON by default. This means the value is treated as PII and masked for users who don't have access to personal data.
| Setting | Meaning | Who sees the value |
|---|---|---|
| Contains personal data ON (default) | Value is treated as personal data | Only users with PII access see the real value; others see it masked |
| Contains personal data OFF | Not personal data | All users see the real value |
To change the PII setting on an existing attribute: open it with the Edit (pencil) icon → scroll to the Personally Identifiable Information (PII) section → toggle as needed → click Update attribute.
Attributes marked as personal data show a lock icon next to their name in the list view.
Disabling the PII toggle on a field that actually contains personal data will make those values visible to all users. This is recorded in the activity log.
For more details on how masking works across the platform, see Role-Based Data Masking.
Draft Mode and Saving
While adding attributes they remain in Draft state. Before clicking Save you can edit any field (including Type and Slug) or delete the draft.
Once you click Save, attributes are permanently locked:
- You cannot delete the attribute
- You cannot change the Type or the API Name (slug)
- You can only modify the display Name and Description
Make sure all technical details are correct before saving.