Queries
product
Fetch a single published product by UID.
query Product($uid: UUID!) {
product(uid: $uid) {
uid
name
tagline
description
contentBlocks
variants {
uid
name
inventoryCount
prices {
uid
currency
isDefault
recurringInterval
price {
... on LinearProductPriceConfig {
priceModel
unitPrice
}
... on VolumeProductPriceConfig {
priceModel
tiers {
firstUnit
lastUnit
unitPrice
}
}
}
}
media {
uid
type
url
alt
}
deliverables {
uid
name
type
description
}
}
defaultVariant {
uid
name
}
createdAt
updatedAt
}
}
productsByStoreUid
List all published products in a store.
query StoreProducts($storeUid: UUID!) {
productsByStoreUid(storeUid: $storeUid) {
uid
name
tagline
description
defaultVariant {
uid
prices {
currency
isDefault
price {
... on LinearProductPriceConfig {
unitPrice
}
}
}
media {
uid
url
alt
}
}
}
}
Types
Product
| Field | Type | Description |
|---|---|---|
uid | UUID | Product ID |
name | String | Product name |
tagline | String? | Short description |
description | String? | Full description |
contentBlocks | [JSON]? | Structured content blocks |
variants | [ProductVariant] | Product variants |
defaultVariant | ProductVariant | Default variant |
createdAt | DateTime | |
updatedAt | DateTime |
ProductVariant
| Field | Type | Description |
|---|---|---|
uid | UUID | Variant ID |
name | String? | Variant name |
inventoryCount | Int? | Current stock level |
prices | [ProductPrice] | Variant prices |
media | [Media] | Variant images and videos |
deliverables | [ProductDeliverable] | Digital deliverables |
ProductPrice
| Field | Type | Description |
|---|---|---|
uid | UUID | Price ID |
currency | String | ISO currency code |
isDefault | Boolean | Whether this is the default price |
recurringInterval | MONTH | YEAR | null | Billing interval for subscriptions |
trialDuration | String? | Trial period (ONE_DAY, THREE_DAYS, ONE_WEEK, TWO_WEEKS, ONE_MONTH) |
price | LinearProductPriceConfig | VolumeProductPriceConfig | Pricing model |
LinearProductPriceConfig
| Field | Type | Description |
|---|---|---|
priceModel | LINEAR | |
unitPrice | Float | Price per unit in minor currency units (cents) |
VolumeProductPriceConfig
| Field | Type | Description |
|---|---|---|
priceModel | VOLUME | |
tiers | [VolumeTierPrice] | Tiered pricing brackets |
Media
| Field | Type | Description |
|---|---|---|
uid | UUID | Media ID |
type | IMAGE | VIDEO | EXTERNAL_VIDEO | Media type |
url | String? | CDN URL |
alt | String? | Alt text |
ProductDeliverable
| Field | Type | Description |
|---|---|---|
uid | UUID | Deliverable ID |
name | String | Name |
type | DOWNLOAD | CONTENT_UNLOCK | EXTERNAL_LINK | Deliverable type |
description | String? | Description |