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

Listing Attributes

Tool: list_attributes
Input: {
  "search": "Color",
  "sortBy": "name",
  "sortOrder": "ASC"
}

Parameters:

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:

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:

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