Skip to main content

Shopware

Enhance post-purchase retention, upselling, and branding by fully integrating Karla into your Shopware store.

Install the Karla Extension​

Follow these steps to install and configure the Karla extension in your Shopware store.

1. Upload the Extension​

  1. Download the Karla extension from the official releases page. You will typically download the KarlaDelivery.zip file for the latest version.
  2. In your Shopware admin panel, navigate to Extensions > My extensions. Shopware Installation 1
  3. Under My extensions, click Upload extension. Shopware Installation 2
  4. Click Confirm and upload the KarlaDelivery.zip file you just downloaded. Shopware Installation 3

2. Install and Activate​

  1. Once uploaded, click Install next to the Karla extension to begin the installation process. Shopware Installation 4
  2. A success message will confirm the successful installation. Shopware Installation 5
  3. After refreshing the page, the Karla app will show as activated. Click Configure to proceed with merchant-specific settings. Shopware Installation 6

3. Configure the Extension​

  1. Enter your shop slug and API key.
  2. Optionally, you can define a custom target API URL for advanced setups.
  3. Under Shop events, select which events trigger data synchronization with Karla.
  4. Click Save to apply your changes. Shopware Installation 7

Optional settings​

Trigger behavior​

You can select which Shopware events trigger the sending of order and shipment data to Karla.

Shopware Installation 8

Now your shop is fully integrated with Karla!

Mappings​

Use Mappings to define line item types (e.g., 'deposit'). This lets you exclude them from the order summary on the tracking page.

Shopware Installation 9

Multi-tenant​

For Shopware instances with multiple sales channels, this configuration links each sales channel to a specific Karla shop ID. This enables using multiple Karla shops with a single Shopware instance.

Shopware Installation 10

You can retrieve the version of your sales channel if you click on it in the admin panel and you check the url: for instance in https://<your-shop-domain>/admin#/sw/sales/channel/detail/98432def39fc4624b33213a56b8c944d/base, 98432def39fc4624b33213a56b8c944d is the sales channel id.

warning

Make sure that the provided API credentials have access to all the shops defined in this setting. It is possible to have multi-shop credentials.

Upgrade the Karla extension​

If you already have the Karla plugin installed and want to get benefit from the latest plugin features, just upload the latest KarlaDelivery.zip file as described in upload the extension.

You will then see an option to update your currently installed extension.

Shopware Update 1

After clicking update, your plugin will be automatically updated to that version with the settings you set before.