Most Common Errors - Shopware

Shopware installation checklist

If something goes wrong during the installation you could have made any of these mistakes:

Use this checklist when installing or reinstalling the Doofinder app on Shopware 6. Most issues fall into one of four categories: account/login, license, environment (live vs. staging), and domain/APP_URL configuration.

1. Account & Login

• Use a shared/company account, not a personal one: Avoid installing under an individual's personal email. If that person leaves or is unavailable, no one else can access or manage the store connection. Use a team account instead.
• Fully remove the extension before reinstalling: If errors persist after logout, confirm the extension was completely removed (not just disabled) and clear the browser cache, or try in a different browser/incognito window.
• Always log out before reinstalling the app (only if changing Accounts during reinstallation): If you uninstall and then reinstall the app, if doing it without logging out first, Shopware will try to reuse the previous session, meaning, the previous account on the next install instead of prompting for fresh credentials, this causes installs to silently attach to the wrong account.
• "User not allowed" or stuck on the same account? This usually means the store is still linked to a different Doofinder account than the one you're logged in with. Contact support to check which account the store is currently associated with, and have it reassigned if needed.
• Store limit reached error: This can happen due to leftover/deleted store records still being counted. Contact support to verify and raise your store limit if needed.

2. License Conflicts (Staging vs. Live)

• Check whether the same license is already active elsewhere. A single license can only be active on one installation at a time. If the same license is used on both a staging/Dev site and the live site, only one will work correctly.
• Confirm you're installing on the correct environment. Double-check the URL before starting installation. Staging/Dev URLs often contain "dev" or similar in the domain. Make sure you're logged into the live site's admin, not the Dev one, unless staging is intentionally the target.

3. General Installation Steps

• Follow the official installation documentation step by step. See here!
• To access the Shopware admin directly: go to the site's domain and add /admin at the end (e.g. https://yourshop.com/admin).
• If everything looks correctly configured but Doofinder details don't appear on the storefront, clear the Shopware cache: Einstellungen (Settings) > System > Caches > Clear it, at least a few times.