Provides comprehensive Saleor e-commerce domain knowledge including entity types, relationships, identifier rules, and GraphQL patterns. This skill should be invoked when the user needs to understand Saleor concepts, entity relationships, the difference between product-level and variant-level attributes, or how channels, warehouses, and shipping zones interact. Essential for understanding how Configurator maps to Saleor's data model.
View on GitHubsaleor/configurator
saleor-configurator
February 3, 2026
Select agents to install to:
npx add-skill https://github.com/saleor/configurator/blob/main/plugin/skills/saleor-domain/SKILL.md -a claude-code --skill saleor-domainInstallation paths:
.claude/skills/saleor-domain/# Saleor Domain Knowledge
Saleor is a headless e-commerce platform built with Python/Django and GraphQL. This skill provides essential domain knowledge for configuring Saleor stores.
## Core Entities
### Channel
Channels represent sales channels (storefronts, marketplaces, regions). Each channel has its own:
- Currency
- Default country
- Product visibility and pricing
- Checkout and order settings
```yaml
channels:
- name: "US Store"
slug: "us-store"
currencyCode: USD
defaultCountry: US
```
### Product Type
Defines the structure of a product category with:
- Product-level attributes (shared across variants)
- Variant-level attributes (differ per variant)
- Shipping requirements
- Tax class
```yaml
productTypes:
- name: "T-Shirt"
isShippingRequired: true
productAttributes:
- name: "Brand"
variantAttributes:
- name: "Size"
- name: "Color"
```
### Product & Variant
Products are the items you sell. Each product:
- Belongs to one product type
- Can be in multiple categories
- Has one or more variants (SKUs)
Variants represent purchasable items with:
- Unique SKU
- Specific attribute values
- Channel-specific pricing
- Inventory tracking
### Attribute
Attributes define product/variant characteristics:
| Attribute Level | Description | Example |
|----------------|-------------|---------|
| **Product** | Same for all variants | Brand, Material |
| **Variant** | Differs per variant | Size, Color |
### Category
Hierarchical product organization:
- Tree structure with parent/child relationships
- Products belong to leaf categories
- Used for navigation and filtering
### Collection
Curated product groupings:
- Can span multiple categories
- Manual or rule-based membership
- Used for promotions, featured sections
### Warehouse
Physical or virtual inventory locations:
- Stock tracking per warehouse
- Shipping zone associations
- Click & collect support
### Shipping Zone
Geographic shipping regions:
- Country-bas