Create a product
Create a product in Catalog:
- Go to Catalog and click on Add product in the top right-hand corner.
- Add your product details. The only field required to create a product is the SKU and/or product ID field(s). These fields will be used to reference your catalog products. Learn more about Catalog’s identifiers.
- Optional— Add your classification details.
- Optional— Add your shipping information (weight, dimensions, units of measure, etc.).
- Optional— Add restricted countries.
- Click save product.
Create multiple products in Catalog:
Upload multiple products or your entire product catalog at once.
If you attempt to create a product that already exists, Catalog will recognize the product based on the SKU and/or product ID and override the original product's details with the new details.
Edit a product
To edit a product:
- Click on the Products tab.
- Select the product you want to edit.
- Make your changes.
- Click save product.
Learn how editing existing products affect your data.
Delete a product
To delete a product:
- Click on Products tab.
- Select the product(s) you want to delete. Once your product(s) are selected, a delete button will appear.
- Click delete and then delete again to confirm your deletion.
Restrict a product
If you want to prevent shipments to a certain country (or countries), you can add restrictions when creating or updating a product.
To restrict a single product in Catalog:
- Click on the Products tab.
- Select the product you want to add a restriction to, which will open the edit page.
- Find the Restricted countries section at the bottom of the edit page.
- Add the countries you want to restrict your product to by selecting or typing the country name(s).
- Click save product.
To restrict multiple products in Catalog:
- Click on the Import/export tab.
- Download the Catalog template CSV.
- Fill out the template with your product details. Include your SKU/Product ID and restricted countries by following the Catalog CSV format.
- Save your file as a CSV and upload to Catalog by dragging and dropping or selecting your file by clicking browse on the same page you downloaded the CSV from.
- Review your uploaded products in the preview screen and click upload.
If you would like to restrict catalog products in bulk via CSV, follow the product CSV description format.
Filtering restricted products:
You can filter restricted products directly in the catalog by downloading your entire catalog in CSV format from Dashboard and opening it in Excel or Google Sheets. From there, you can use the filtering feature to view only the restricted products. This allows you to easily locate and manage the restricted products in your catalog.
If you need to update your catalog after making changes to your CSV, reupload the file and any matching products will be replaced with the updated version. This is done by identifying and matching the SKU and/or product ID.
If you're using Checkout, a restricted message will be displayed in your checkout when a product is restricted to the customer's country. By default, the message will say "This item is restricted from import to your country," but you can customize your own restricted message by providing it in the restrictedCountriesMessage field when adding your country restrictions.
Filter a product
You can search for products in Catalog through Dashboard or via API using either the SKU or product ID. Note that only exact matches will return results; partial matches will not be recognized.
To filter by SKU or product ID:
- Click on the Products tab.
- Select SKU or Product ID in the top left corner of your Catalog.
- Enter your SKU or product ID.
- Click Apply to view your filtered product(s).
Export your products in Dashboard
When you export your products, it will automatically export your entire product catalog in a CSV file.
- Go to the main page of your Catalog.
- Click the Export button next to Add product.
- Find your full catalog file in your downloads.
Classify a catalog product via API
You can classify a product from your catalog by using the catalogItemId in the ClassificationsCreateFromCatalog mutation.
Note that a name is required to classify a product from your catalog. Consult the GraphQL API reference for a complete catalog and classification fields list.
To create and classify a catalog product simultaneously, add the ClassificationsCreateFromCatalog mutation below to your CatalogItemsCreate mutation.
Classify a catalog product to the 8+ digit (country-specific)
When the shipToCountries field is populated, the classification will be 8+ digit (country-specific) HS code. If no shipToCountries are provided, the classification will default to a 6-digit (universal) HS code. Learn more about the distinctions between universal and country-specific HS codes.
In the example below, the shipToCountries field is provided to generate a country-specific code for Canada.
Mutation
mutation ClassificationsCreateFromCatalog(
$catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
id
configuration {
shipToCountries
}
hsCode {
code
}
name
}
}
Here’s an example of a request. While Zonos Classify will generate a classification with just a name, we strongly recommend adding as many details as possible for the best classification results.
Variables
{
"catalogItemToClassify": [
{
"catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
"configuration": {
"shipToCountries": ["CA"]
}
}
]
}
Response
{
"data": {
"classificationsCreateFromCatalog": [
{
"id": "classification_8C49fk2945jmm232CcQtHtXdu",
"configuration": {
"shipToCountries": ["CA"]
},
"countryOfOrigin": "US",
"hsCode": {
"code": "6116.10.0020"
},
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
}
]
}
}
Manage catalog
Create and modify products.Learn how to add, modify, and delete your Zonos Catalog product(s) in Dashboard or via API. Use Catalog in Dashboard to avoid writing code or if you're making small changes. If you want to directly integrate with Catalog for production implementations, use the API.