CatalogItems
Returns all catalog items in the account, including product details, pricing, and availability information.
Select
The component uses the Klaviyo API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the component.
- Id supports the following operator: =, IN
- Published supports the following operator: =
SELECT * FROM CatalogItems Where Id = 'catalogcategoryId'
SELECT * FROM CatalogItems Where Published = true
Insert
You can create new catalog items.
Note: Creating a new catalog item does not automatically associate it with a catalog category. To associate an item with a category, insert a record into the CatalogCategoryItems table.
INSERT INTO CatalogItems (ExternalId, Price, Title, Description, URL) VALUES ('catalogitem-externalid', '44', 'Limited Edition 2025 T-Shirt', 'A blue T-Shirt', 'https://cdata.com')
Update
You can update catalog items by specifying the Id of the item and setting the fields to update.
UPDATE CatalogItems
SET Description = 'Limited Edition 2025 T-Shirt, Low on Stock, Order now'
WHERE Id = 'lowStockItemId'
Delete
You can delete a catalog item by specifying the Id of the record you want to remove.
DELETE from CatalogCategories Where Id = 'lowStockItemId'
Columns
| Name | Type | ReadOnly | References | Description | |
| Id [KEY] | String | True |
The unique identifier for the catalog item. This compound Id uses the format {integration}::: {catalog}::: {external_Id}. Currently, only the $custom integration type and the $default catalog are supported. | ||
| Created | Datetime | True |
The date and time when the catalog item was created, in ISO 8601 format (YYYY-MM-DDTHH:MM:SS.mmmmmm). | ||
| Description | String | False |
A detailed description of the catalog item, typically including product information or relevant attributes. | ||
| ExternalId | String | False |
The identifier of the catalog item in an external system, used to link Klaviyo catalog data with external product sources. | ||
| ImageFullUrl | String | False |
The URL of the primary full-size image representing the catalog item. | ||
| ImageThumbnailUrl | String | False |
The URL of the thumbnail image associated with the catalog item. | ||
| Images | String | False |
A comma-separated list of URLs for all images linked to the catalog item. | ||
| Price | Double | False |
Specifies the price displayed for the catalog item in Klaviyo emails and campaigns. For most price updates, you should also update the prices for related variants using the Update Catalog Variant endpoint. | ||
| Published | Bool | False |
Indicates whether the catalog item is currently published and available in the account's catalog. | ||
| Title | String | False |
The title or display name of the catalog item as it appears in the catalog or storefront. | ||
| Updated | Datetime | True |
The date and time when the catalog item was last updated, in ISO 8601 format (YYYY-MM-DDTHH:MM:SS.mmmmmm). | ||
| Url | String | False |
The URL directing to the catalog item's page on the organization's website. |