# Attribute Management

> Attribute CRUD, adding attribute values, and variant configuration. Use when creating product attributes like color, size, or material, or managing attribute values.

- Skill: `agents-store/attribute-management` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agents-store/attribute-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agents-store/attribute-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agents-store (https://skillmd.com/u/agents-store)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agents-store/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