Channable
Globe icon
English (US) Deutsch Español Français Italiano Nederlands
  1. Help Center - Channable
  2. Imports
  3. Import setups

Articles in this section

See more

Import items from Shopware 6 via our app

In this article, you'll learn how to import product data from Shopware 6 into Channable.

Note: This article is about importing your products from Shopware 6 using our app. If you have Shopware 5, check out our Shopware 5 setup guide.

Before you start

You'll need

  • A Shopware 6 account

Good to know

Importing from a staging environment: You must whitelist Channable's IP addresses to connect through a staging environment. Without whitelisting, you may receive misleading errors suggesting your credentials are incorrect. 

To prevent this, please contact our Support team to request our IP addresses and add them to your staging environment whitelist before continuing.

 

Contents

 

Step 1: Download the Channable Integration app

To import your product data from Shopware 6 to Channable, you'll need to install the Shopware 6 Channable Integration app.

The app can be installed in two ways: through your Shopware admin account, or Composer.

Important: You must connect to Channable within 24 hours of installing the app to prevent your connection from expiring. If your connection expires, you'll need to install the app again.

Install with Shopware 6 admin

  1. Log in to your Shopware 6 admin account. (accessible by adding /admin to the end of your shop domain)
  2. Go to Extensions > Store.
  3. In the search bar, search for “Channable” and select the Channable integration app.
  4. Click Add extension.
  5. Follow the steps in the installation wizard.
  6. Go to Extensions > My extensions.
  7. Click Install next to the Channable app.
  8. Click the to activate the app.

Install with Composer

  1. In the Shopware store, download the Channable Integration app. This is free to install.
  2. Add the app to the cart and proceed to checkout. 
    1. You will need to log in to the Shopware store, if you haven't done so.
    Note: Make sure you select your shop's domain on the checkout page.
  3. Click Complete payment.
  4. In the Merchant section of your Shopware account, go to Shops and select the correct shop.
  5. Scroll to License list and click Channable Integration.
  6. Click Install via Composer.
  7. A pop-up will appear with further instructions. Follow these to install the app. 
     


Step 2: Connect with Channable

At this point, the Channable Integration app should be installed to your Shopware 6 account.

  1. In your Shopware 6 admin account, go to Settings > Connect to Channable.
  2. Click Connect to Channable.
    EN - Shopware 6 (4).jpg
  3. You will be redirected to Channable to create your connection. If you haven't logged in yet, you'll be prompted to do so.
  4. Click Add connection.
  5. Open the project you want to import your product data to.
  6. Go to Setup, click + Set up import and select Shopware 6.
  7. At Choose an existing connection or create a new one, select the Shopware 6 connection you just made.
  8. Provide the requested information:
    1. For Name, give your channel a descriptive name (e.g. "Shopware EN")
    2. For Choose language, select the language your import data is in.
    3. For Import filter, select whether you only want to import active products or not.
  9. Click Start import. You'll be redirected to the Edit Mapping step to map your product information.
     

Step 3: Map your products

This page displays your import fields (fields retrieved from your Shopware 6 webshop [e.g. price, description, title]), and corresponding project fields (Channable's standardized fields used to streamline channel setups).

Note: Our system will automatically detect and map most import fields our standardized fields, but it's important to review and adjust these before importing.
  1. Compare and adjust mapping: 
    Review your Import fields against Channable's matched Project fields. If a field was matched incorrectly, click on the field to select a different field.
  2. Check and correct field types:
    Check that the right field type is assigned to your project fields. If a field has the wrong type, click Edit next to the field, select the correct type in the dropdown, and click Save & Import.
  3. Exclude fields (optional):
    To exclude a field from being included in your product data, click the checkbox in the Select column for that field and click Do not import selected fields.

Once you've finished mapping, click Save & Import to start importing your product data. Depending on how much data you're importing, this can take some time. 

Tip: Check the Status column in Setup to check your import progress. Your product data is fully imported when the Status is Finished.

 

Step 4: Review your imported items

After your product data has finished importing:

  1. Go to the Items page to view your imported products.
  2. Click on an item to see detailed information. 
product-details.gif

You're good to go! Your items are ready to use to create and optimize Feeds, Marketplaces, Shopping Ads, and more in Channable.

 

Adding additional Shopware connections

To add more Shopware connections (e.g. for different locales), repeat the steps in this article starting from Step 2. 

Troubleshooting

Error: Connection with your eCommerce platform expired.

To solve this error, you'll need uninstall and reinstall the Channable app in your Shopware backend.

EN - Shopware 6 (8).jpg

  1. In your Shopware backend, go to Extensions > My Extensions.
  2. At your Channable extension, click > Uninstall.
  3. Repeat the steps in this article again, starting from Step 2.
     
    Important: You must connect to Channable within 24 hours of installing the app to prevent your connection from expiring. If your connection expires, you'll need to install the app again.

The link<> field for my product contains an incorrect URL.

We create these links by retrieving information from your Shopware backend. The domain for each URL is retrieved from the sales channel settings, so please ensure these settings are filled in correctly:
EN - Shopware 6 (1).jpg

I have a custom field that contains an image, but I only receive an ID instead of an image link.

Retrieving the URL instead of the ID will put additional strain on your server, as we’re doing one additional request per product. Therefore, we only want to do this when it’s necessary. If you want us to activate the feature that turns these IDs into URLs, you can contact our support team.