Shopware 6 CAPTCHA Plugin

The following tutorial will guide you on how to integrate the TrustCaptcha CAPTCHA solution into your Shopware 6 store to protect it from bots and spam.

You should have already completed the following steps before you start to integrate TrustCaptcha into your Shopware 6 website.

1. Read Get-Started: Get a quick overview of the concepts behind TrustCaptcha and the integration process in get started.

2. Existing CAPTCHA: If you don’t have a CAPTCHA yet, sign in or create a new user account. Then create a new CAPTCHA.

3. Existing Shopware 6 website: You need a Shopware 6 website in which you want to integrate TrustCaptcha.

TrustCaptcha registers itself as a native CAPTCHA solution within Shopware 6. Once activated under Active CAPTCHAs, Shopware automatically displays it on the storefront forms it natively integrates a CAPTCHA into. Based on our tests, this typically includes:

• Customer registration
• Contact form
• Checkout (guest order / registration during checkout)
• Newsletter sign-up
• Product reviews

Whether and where the CAPTCHA appears is ultimately decided by Shopware and your storefront theme. Some custom forms or third-party form extensions may require CAPTCHA support to be enabled in their own settings before TrustCaptcha is shown there.

Follow the steps below to integrate the TrustCaptcha CAPTCHA plugin into your Shopware 6 store.

Perform the following steps to install the CAPTCHA plugin.

Install via zip upload

1. Download our plugin file here.
2. Log in as an administrator. Navigate to Extensions → My extensions and click the Upload extension button. Upload our plugin as a complete ZIP archive.
3. Once the upload is finished, locate TrustCaptcha in the extension list and install and activate the extension.

Install via Shopware Store (coming soon)

The plugin is not currently available in the official Shopware Store. We will publish the plugin there as soon as possible.

Follow these steps to configure TrustCaptcha in your Shopware 6 store:

1. (Login as an admin to your Shopware 6 administration.)
2. Navigate to Settings → Basic information (in older Shopware versions: Settings → Shop → Basic information) and scroll down to the CAPTCHA section.
3. Open the Active CAPTCHAs dropdown. We recommend removing all other entries and selecting only TrustCaptcha to avoid conflicts with other CAPTCHA solutions.
4. In the TrustCaptcha settings that appear below, enter the site-key and the api-key (formerly secret-key) of your CAPTCHA. You can find and manage these keys in your CAPTCHA settings.
5. Optional: Adjust additional settings such as language, theme, or threshold as needed.
6. Click Save to apply your changes.

The TrustCaptcha plugin for Shopware 6 is now successfully installed and configured. TrustCaptcha will automatically appear on the storefront forms covered by Shopware’s built-in CAPTCHA integration.

Once you have successfully installed and configured TrustCaptcha on your website, you can use TrustCaptcha to its full extent. However, we still recommend the following additional technical and organizational measures:

• Security rules: You can find many security settings for your CAPTCHA in the CAPTCHA settings. These include, for example, authorized websites, CAPTCHA bypass for specific IP addresses, bypass keys, IP based blocking, geoblocking, individual difficulty and duration of the CAPTCHA, and much more. Learn more about the security rules.

• Data protection: Include a passage in your privacy policy that refers to the use of TrustCaptcha. We also recommend that you enter into a data processing agreement with us to stay GDPR-compliant. Learn more about data protection.

• Accessibility: Customize TrustCaptcha to your website so that your website is as accessible as possible and offers the best possible user experience. More about accessibility.

• Testing: If you use automated testing, make sure that the CAPTCHA does not block it. Learn more about testing.