DOCS

Channel integrations

Connect your sales channel to your Verified Account so Zonos can pull your catalog items and keep them compliance-ready for U.S.-bound shipments.

Channel integrations connect your ecommerce platform to your Zonos Verified Account. Once connected, Zonos automatically pulls your catalog items and keeps them in sync—no manual data entry required. Every item in your catalog is then screened for U.S. Partner Government Agency (PGA) requirements, so your shipments don't get held at the border.

This is the option for shippers who sell through one of the supported platforms below. It's the least work of the three ways to build your catalog—there's nothing to export, upload, or code, and your catalog stays current on its own as you add or change products. Connecting a channel takes a few minutes in Dashboard and doesn't require a developer.

If you don't sell through a supported channel, you can import your catalog items with a CSV file or write them directly with the Catalog API instead. Items added either way get the same treatment as synced items.

How it works 

  1. Connect your sales channel to your Verified Account in Dashboard.

  2. Zonos pulls your catalog items from the channel and keeps them up to date as you add or change products.

  3. Every item is automatically screened for PGA requirements—such as CPSC and FDA regulations—that apply to U.S. imports. Items that need more information show an Open requirements badge in your catalog and on the Requirements tab, and Zonos pre-fills most of the required answers for you to review and confirm. Learn more about PGA checks.

  4. You ship as usual. Because your items are screened before they ship, U.S.-bound shipments are less likely to be delayed or held at the border.

Note: Syncing runs on a schedule rather than instantly. Orders are checked hourly and catalog every two hours. The Channels page shows when orders and catalog each last synced for a connection, so you can always see which of the two you're waiting on. Some situations make a sync take longer—see When syncing takes longer.

Note: PGA checks apply to all U.S. inbound shipments. Shipments to other destinations are not affected.

Supported channels 

You can connect the following channels to your Verified Account:

Map product fields 

If your store keeps product details in fields of its own—metafields in Shopify, product attributes in Magento, or custom fields and product attributes in WooCommerce—map them so Zonos syncs the values into your catalog.

  1. On the Channels page, open the menu on your channel and choose Metafield mapping (Shopify), Product attribute mapping (Magento), or Product field mapping (WooCommerce).
  2. Click Add field, choose the catalog field, and enter the name of the field in your store that holds it. Add a row for each field you want to map.
  3. Click Save.

Saving a changed mapping re-syncs your whole catalog right away, so existing products pick up the values without you editing them in your store. To stop syncing a field, remove its row and save; values already synced stay in your catalog. A field that's empty in your store never overwrites a value you've added in your Zonos catalog.

Fields you can map

Channel↕Catalog fields↕What to enter↕
ShopifyBrand, material composition, customs descriptionThe metafield's namespace and key
MagentoBrand, material composition, customs description, GTIN, manufacturer product ID, country of origin, HS codeThe attribute code, from Stores > Attributes > Product
WooCommerceBrand, material composition, customs description, GTIN, manufacturer product ID, country of origin, HS codeA custom field (meta) key or a product attribute name, such as country_of_origin

How values are read

  • Material composition should look like Cotton:60,Polyester:40. Percentages are optional; materials without one share the rest evenly.
  • Country of origin can be a 2- or 3-letter code (AU, AUS) or a country name (Australia). Give each product one country—if a product lists several different countries, it stays empty.
  • GTIN and manufacturer product ID are the EU product identifiers. Map them if your store keeps them somewhere other than its built-in fields.
  • Magento: without a row for brand, GTIN, or manufacturer product ID, Zonos uses attributes coded brand, gtin, or ns_pid when your store has them. A mapped country of origin takes priority over Country of Manufacture, which still applies when the mapped attribute is empty.
  • WooCommerce: a mapped GTIN takes priority over the built-in GTIN field. On variable products, attributes set on the parent and not used for variations apply to every variation; GTIN and manufacturer product ID always come from the variation itself.

What syncs from your channel 

When you connect a channel, new and updated products automatically map to your Zonos catalog. Which fields arrive depends on what your channel stores—each channel's section above lists its gaps. Synced fields include:

  • SKU and product ID
  • Name and description
  • Price and currency
  • Weight and weight unit (Amazon, Magento, Shopify, Wix, and WooCommerce)
  • Universal HS code (Shopify, Faire, BigCommerce customs information, and Magento or WooCommerce with a mapping, when set)
  • Country of origin (Amazon, BigCommerce customs information, Faire, Magento, Shopify, and WooCommerce with a mapping, when set)
  • Brand (every channel except eBay, Etsy, Faire, Square, and Squarespace, when set)
  • Image URL
  • GTIN and manufacturer product ID, for EU product identifiers (varies by channel)
  • Customs description (Shopify, Magento, or WooCommerce with a mapping, and BigCommerce customs information)
  • Material composition (Amazon, and Shopify, Magento, or WooCommerce with a mapping)

Orders sync with their line items, totals, and tracking numbers.

The more complete your product data is in your channel, the more accurate your duty calculations and PGA screening will be. If a field like HS code or country of origin is missing, Zonos can fill in the gaps—see how Catalog works for details.

When syncing takes longer 

Most of the time orders appear within the hour and catalog within two. These are the situations where it takes longer:

  • The first sync after you connect. Zonos pulls your whole catalog, not just what changed, along with your recent order history—so your existing products and orders are there from the start rather than only what happens from now on. A large catalog can take several minutes, and a long order history is fetched across several syncs rather than all at once.
  • A channel that has had nothing new for a while. Zonos checks quiet channels less often—as little as every six hours for orders and every 72 hours for catalog. It returns to the normal schedule as soon as a check finds something, so the first order after a quiet stretch can take longer to appear than the next one.
  • Busy periods. When a lot of connections are waiting to sync, a scheduled run can be skipped and picked up on the following one.
  • The periodic full catalog re-sync. Routine catalog syncs only look at products you've added or changed since the last one, which is why they're quick. Every 14 days Zonos re-reads your catalog in full to catch anything a routine sync missed, and that sweep takes longer—closer to the first sync than to a routine one.
  • A connection that keeps failing. After several consecutive failures Zonos stops syncing that connection until you reconnect it. Its last-synced times stop advancing, which is the signal to reconnect.

Pricing 

Connecting a channel is free. The app that links your Amazon, BigCommerce, eBay, Etsy, Faire, Adobe Commerce (Magento), Shopify, Square, Squarespace, Wix, or WooCommerce account to Zonos costs nothing to install or use, and there is no per-order or per-listing fee for syncing your catalog and orders.

Support 

Questions about connecting a channel, or help with a sync:

  • CSV import — Another way to build your catalog. Use it instead of a channel integration if you don't sell through a supported channel.
  • Catalog API — Write catalog items programmatically from your own system.
  • PGA checks — Screen your catalog items for U.S. agency (PGA) requirements.
  • Supporting documents — Upload certificates and other paperwork for your goods.
Book a demo

Was this page helpful?


Get support·Legal docs·© 2026 Zonos