The message queue in Shopware 6 ensures that many tasks are executed in the background – for example, sending emails, importing/exporting data, or Pickware processes. If it is not working properly, these tasks get stuck, and your shop reacts slowly or with errors. A functioning queue is therefore absolutely necessary for your shop and Pickware to work smoothly. A more comprehensive tutorial on the message queue directly from Shopware can be found here.
How do I know that my message queue is not working properly?
There are a few typical signs that suggest something is wrong with your message queue:
Import and export functions such as the DATEV document export or the import of supplier orders do not work
Since these functions always run through the message queue, they are one of the most common symptoms
Pickware processes are not completed, or only with significant delay
Orders or stock levels are not updated
In the Shopware Administration, tasks permanently remain in the open status
Some Shopware and Pickware tasks are started regularly via so-called scheduled tasks. These tasks are then also processed via the message queue – if the queue is not working, these tasks will not be executed either. So if these processes are no longer working as usual, the cause is often a message queue that is not running.
How do I check the status of my message queue?
If one or more of these symptoms occur, you should first check the status of your message queue. You have the following options for this:
Checking via Frosh Tools
We recommend the free plugin Frosh Tools from Friends of Shopware for checking. Using the traffic light indicator in the top left of your Shopware Administration, you can see live, quickly, and without detours whether there are any problems.
In addition, you can also check in the Warteschlangen-Manager (Queue Manager) section in real time exactly how your messages are being processed.
Here you can (among other functions) view the status of your message queue in detail and see how much delay there is and whether messages are getting stuck in the queue.
Checking via Shopware Admin
The Shopware Admin itself also offers, via Settings → Nachrichtenwarteschlangen-Statistiken (Message Queue Statistics), the option to give you an overview of your message queue, logging processed messages.
What can I do?
If your queue is not working, this is usually because no active worker process is running.
Please contact your hosting provider or administrator and ask them to set up the CLI worker permanently. This processes the queue independently of the Shopware Administration and ensures that all Pickware and Shopware tasks are processed correctly.
You can find instructions on this in the official Shopware documentation: Message Queue and Scheduled Tasks Some hosting providers also offer their own step-by-step instructions:
You can find even more detailed technical information on the message queue in the Shopware documentation for developers.