Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Import and export a catalog

Import or export catalogs to set up a site, sync external data, or move catalogs between websites.

In Optimizely Commerce Connect, you can import and export your catalogs. This helps in the following scenarios:

  • Import products when configuring a Commerce Connect site.
  • Import the product catalog when an external system adds items.
  • Import or export to move or copy catalogs between websites.

While you can manually create a catalog and add catalog entries, that option is difficult to maintain using a large catalog. Instead, use the Import or Export option to move products more efficiently.

Import a catalog

  1. Go to Catalogs > Import.

    screenshot of the Catalogs menu with the Import option highlighted
  2. Click Select File to add your file. You can only upload files with the extension .catalog.

    screenshot of the file selection dialog for uploading a .catalog file
  3. Select your files to import on the Import Dashboard.

    screenshot of the Import Dashboard with a file selected for import
  4. Click Import. You import only one file at a time. If you import more than one file, the others have a Pending status until the import completes.

    screenshot of the Import Dashboard showing an active import and files with Pending status

When an import is Processing, click the X icon to cancel. If an import fails or you cancel it, click the Retry icon to re-import.

Export a catalog

  1. Go to Catalogs > Export.

    screenshot of the Catalogs menu with the Export option highlighted
  2. Click Export.

  3. Select the catalogs to export.

    screenshot of the catalog selection list for export
  4. Click Export. The Catalog Export window displays the export.

    screenshot of the Catalog Export window showing the current export
  5. Click the Download icon beside the export. Your file downloads to your device. The Catalog Export window shows any previous export files and lets you search, sort, and delete.

    screenshot of the Catalog Export window listing previous export files with search, sort, and delete controls

    To delete items from the export, select at least one item and click Delete.

    screenshot of the Catalog Export window with items selected for deletion

Use the API

Import and export catalogs programmatically using the import catalog data or the Service API.