When it comes to robust and scalable eCommerce solutions, Shopware 6 is a platform that often comes to mind. Known for its flexibility and extensibility, Shopware 6 allows for a wide array of customizations—be it in the realm of product management, customer engagement, or order processing. However, the platform is not without its challenges, especially when it comes to data import and export functionalities.

Specifically, businesses with unique operational requirements may find that the default capabilities of Shopware’s import/export toolset do not fully meet their needs. For instance, you might have custom entities that don’t fit neatly into the standard product, customer, or order data models. Moreover, even when dealing with built-in entities, you might encounter challenges when trying to import complex rulesets—these can be multi-faceted conditions affecting product availability, pricing, or promotional offers.

Such complexities necessitate digging deeper into the platform’s architecture to extend its capabilities. This article aims to serve as a comprehensive guide for tackling two such complexities: adding custom entities to your import/export processes and addressing challenges that come up during Rule importation.

To illuminate these topics, we’ll dive into code-level details, providing real-world examples and solutions that have been successfully implemented. We’ll start with a quick overview of the import mechanism in Shopware 6, then move on to adding custom entities, and finally discuss how to overcome challenges with Rule import.

By the end of this article, developers and Shopware administrators alike should have a thorough understanding of how to adapt the Shopware 6 platform to better suit advanced data import and export requirements.

Now, let’s dig into the technicalities.

Shopware 6 import mechanism: A quick overview

Shopware’s standard import tool is built to support a range of entities like products, orders, and customers. However, there may be scenarios where the built-in features don’t suffice. For example, you may need to import custom entities or face issues when trying to import Rules, which can include complex conditional statements.

Adding custom Entities and Rules to imports and exports

Shopware 6 allows you to extend its import and export functionalities by adding custom entities. In our case, we’ve added three new entities for both import and export: Rule, Rule Condition, and Custom Entity.

To achieve this, we modified the “supportedEntities” array of the sw-import-export-edit-profile-general component in our custom plugin to include these new entities. The updated array specifies the value, label, and type of entity for both import and export.

Also don’t forget to include the new file in your main.js:
import ’./extend/sw-import-export-edit-profile-general’;
And run command :

By making these changes, we’ve successfully extended the capabilities of Shopware 6’s import/export tool to support rules, rule conditions, and custom entities.

Challenges in Rule Import

Importing Rules in Shopware 6 can get complicated because of the various field types and their serialization needs. Specific issues arise when trying to import a Rule that is not straightforwardly handled by Shopware’s default FieldSerializer.

Solution: FieldSerializer Decoration

To augment the capabilities of the original FieldSerializer class in Shopware, we’ve created a decorator. The key changes are as follows:

  • Add another “elseif” statement to the serialize method:
  • Create a new private method:

Now we can create new profiles for our imports and exports:

Want to explore the best eCommerce technologies and deep dive into Shopware? Check out our free e-book – A comprehensive guide to choosing the best technologies for eCommerce


Extending the import capabilities of Shopware 6 is not just about modifying configuration files; it sometimes requires more in-depth customization, like in the cases discussed above. This article provides practical solutions for adding custom entities and resolving Rule import issues. With these adjustments, you should find it significantly easier to work with Shopware’s import/export features.

If you have any questions about this topic, please get in touch with us!