Skip to content
CatalogRelay

Quick Start

This guide walks you through the minimum setup to get a supplier feed importing and exporting to a store. Estimated time: 15 minutes.

Prerequisites

Section titled “Prerequisites”
  • A CatalogRelay account (register here)
  • A supplier feed URL (CSV, XML, or JSON)
  • Access credentials for your store (Magento, Shopify, or WooCommerce)

Step 1: Add a supplier

Section titled “Step 1: Add a supplier”
  1. In the dashboard, go to Suppliers → Add supplier
  2. Enter a name for the supplier (e.g. “Acme Wholesale”)
  3. Click Save

Step 2: Add an import feed

Section titled “Step 2: Add an import feed”
  1. On the supplier detail page, click Add feed
  2. Enter the feed URL (must be publicly accessible or require HTTP Basic Auth)
  3. Select the format: CSV, XML, JSON, or API
  4. Set a schedule or leave as Manual for now
  5. Click Save and run now

CatalogRelay will download the feed and start processing it in the background. Large feeds (millions of rows) are split into 1,000-row chunks and processed in parallel.

Watch the import run

Section titled “Watch the import run”

Go to Suppliers → select your supplier → Import runs. You’ll see the run appear with status running. When complete, it shows:

  • Total rows processed
  • How many products were created vs. updated
  • Any rows that failed (with error details)

Step 3: Map your attributes

Section titled “Step 3: Map your attributes”

After the first import, CatalogRelay shows which columns the supplier’s feed contains. Go to Data Mapping → Attributes and map the supplier columns you care about to your catalogue attributes.

For example:

  • Supplier column lieferzeit_de → your attribute Delivery Days
  • Supplier column EAN → maps to GTIN automatically

You only need to set up mappings once. Every future import from this supplier will use the same mappings.

Step 4: Set up pricing rules

Section titled “Step 4: Set up pricing rules”

Go to Pricing Rules → Add rule.

The most common setup is a cost-plus margin:

  • Type: Cost plus percent
  • Margin: 30
  • Applies to: All products (or filter by supplier, brand, or category)

With this rule, if a supplier’s price is €100, your export price is €130. If the supplier raises their price to €110, your export price automatically becomes €143 — your margin is always preserved.

Step 5: Connect your store

Section titled “Step 5: Connect your store”

Go to Export Destinations → Add destination.

Select your platform:

  • Shopify — enter your store domain and API credentials
  • Magento 2 — enter your store URL, API token, and store view
  • WooCommerce — enter your store URL and consumer key/secret

CatalogRelay validates the connection before saving.

Step 6: Create an export profile

Section titled “Step 6: Create an export profile”

Go to Export Profiles → Add profile.

  1. Give it a name (e.g. “All products to Shopify”)
  2. Select the destination you just connected
  3. Set a schedule (e.g. every hour)
  4. Optionally add filters (e.g. only in-stock products, only specific categories)
  5. Click Save and run now

The export run pushes your normalized, priced products to the destination store. The first run is a full sync. Subsequent runs use delta mode by default (only pushing products that changed).

You’re done

Section titled “You’re done”

Your setup is now running automatically:

  1. CatalogRelay downloads your supplier’s feed on schedule
  2. New and changed products are normalized and stored
  3. Your pricing rules are applied
  4. Changed products are pushed to your store

Check the Dashboard for an overview of active suppliers, recent runs, and any alerts.

Next steps

Section titled “Next steps”