attribute-management

# Attribute Management This skill covers attribute operations — creating attributes (color, size, material, etc.), managing their values, and configuring which attributes can be used as product variants. ## Available Tools | Tool | Description | |------|-------------| | `list_attributes` | List all attributes with search and sorting | | `get_attribute` | Get single attribute with all its values | | `create_attribute` | Create a new attribute | | `update_attribute` | Update attribute name or variant flag | | `delete_attribute` | Delete an attribute | | `add_attribute_values` | Add new values to an existing attribute | ## Listing Attributes ``` Tool: list_attributes Input: { "search": "Color", "sortBy": "name", "sortOrder": "ASC" } ``` **Parameters:** | Parameter | Type | Values | Description | |-----------|------|--------|-------------| | search | string | any | Search by attribute name | | sortBy | string | id, name, createdAt, updatedAt | Sort field | | sortOrder | string | ASC, DESC | Sort direction | ## Getting an Attribute ``` Tool: get_attribute Input: {"id": 1} Returns: { id, name, type, isVariant, shopId, values[], createdAt, updatedAt } ``` ## Creating Attributes ### Create Text Attribute ``` Tool: create_attribute Input: { "name": "Material", "type": "select" } ``` ### Create Variant Attribute ``` Tool: create_attribute Input: { "name": "Size", "type": "select", "isVariant": true } ``` ### Create Color Attribute ``` Tool: create_attribute Input: { "name": "Color", "type": "color", "isVariant": true } ``` **Fields:** | Field | Type | Required | Description | |-------|------|----------|-------------| | name | string | YES | Attribute name (e.g., "Size", "Color") | | type | string | YES | Attribute type: "select", "color", "text" | | isVariant | boolean | no | Can be used to create product variants | **Attribute types:** - `select` — dropdown with predefined values (Size: S, M, L, XL) - `color` — color picker with hex values and color names - `text` — free text input ## Adding Attribute Values ``` Tool: add_attribute_values Input: { "id": 1, "values": ["S", "M", "L", "XL", "XXL"] } ``` Values are added to existing ones (not replaced). ## Updating Attributes ``` Tool: update_attribute Input: { "id": 1, "name": "Clothing Size", "isVariant": true } ``` **Updatable fields:** | Field | Type | Description | |-------|------|-------------| | name | string | Attribute display name | | isVariant | boolean | Enable/disable as variant selector | ## Deleting Attributes ``` Tool: delete_attribute Input: {"id": 1} ``` Note: Deleting an attribute removes it from all products that use it. ## Variant Attributes Attributes marked with `isVariant: true` can be used to create product variants. For example: - **Size** (isVariant: true) → allows creating "T-Shirt S", "T-Shirt M", "T-Shirt L" as separate variants - **Color** (isVariant: true) → allows "Blue Sneakers", "Red Sneakers" as variants - **Material** (isVariant: false) → informational only, no variants created ## Common Workflows ### Set Up Clothing Store Attributes ``` 1. create_attribute(name="Size", type="select", isVariant=true) -> Get ID 2. add_attribute_values(id, values=["XS","S","M","L","XL","XXL"]) -> Add sizes 3. create_attribute(name="Color", type="color", isVariant=true) -> Get ID 4. add_attribute_values(id, values=["Red","Blue","Black","White"]) -> Add colors 5. create_attribute(name="Material", type="select") -> Informational 6. add_attribute_values(id, values=["Cotton","Polyester","Wool","Silk"]) -> Add materials ``` ### Set Up Electronics Attributes ``` 1. create_attribute(name="Storage", type="select", isVariant=true) 2. add_attribute_values(id, values=["64GB","128GB","256GB","512GB","1TB"]) 3. create_attribute(name="Color", type="color", isVariant=true) 4. add_attribute_values(id, values=["Black","Silver","Gold"]) 5. create_attribute(name="RAM", type="select") 6. add_attribute_values(id, values=["4GB","8GB","16GB"]) ``` ### Extend Existing Attribute ``` 1. get_attribute(id) -> Check current values 2. add_attribute_values(id, values=["NewValue1", "NewValue2"]) -> Add new values ``` ## Best Practices 1. **Mark variant-capable attributes** with `isVariant: true` from the start 2. **Use "select" type** for fixed value sets (sizes, materials) 3. **Use "color" type** for color attributes to enable visual color pickers 4. **Create attributes before products** — easier to assign during product creation 5. **Add values in bulk** using add_attribute_values rather than one at a time 6. **Don't delete attributes** that are in use by products without updating those products first