This article is part of the Integration series. Before following the guide below, make sure you have read the general overview article Choose your Axeptio integration method.
Are you already loading Axeptio via another method (GTM, hardcoded, or other)? In that case, you do not need to follow this guide.
Install and activate the Axeptio extension
For the Axeptio extension for WordPress to work, you must install the free plugin WP Consent API. It allows WordPress extensions to communicate with each other about visitor consent. You will therefore be automatically asked to install and activate it before you can activate the Axeptio extension.
Log in to your WordPress administration.
In the left menu, go to Plugins > Add New.
In the search bar, type "Axeptio":
Identify our extension, and click "Install Now". 5. Once the extension is installed, click "Activate".
If you prefer, you can also retrieve the archive from our extension page on the WordPress plugin directory and follow the installation instructions.
Link the extension to your Axeptio project
In the left menu, locate the new item named "Axeptio" that should have been added during installation.
In the Project ID field, enter your identifier.
Activate the widget and it will appear on your website.
The "Project Version" field allows you to force the loading of a specific configuration of your banner. If you leave the default option "Dynamic (based on Axeptio)", Axeptio will automatically decide which configuration to load (either through URL-based rules, or through geolocation).
Configure Google Consent Mode v2
Are you using Google services on your website? If the answer is yes, then you must configure Consent Mode! If you do not adopt it, your measurement data in Google Analytics and Google Ads will be incomplete, and certain advertising features may be disabled by Google for your European visitors. Learn more in our dedicated article
The Axeptio extension manages the setting of Google's Consent Mode V2 signals.
On the Axeptio administration side, activate the Consent Mode v2 screen.
Back in WordPress administration, go to Axeptio > Google Consent Mode.
Activate Google Consent Mode v2. Toggles will appear to allow you to define the default signals for the 4 parameters.
For each parameter, set the default signal:
Checked: granted by default
Unchecked: denied by default
If you don't know how to set your default signals, learn more here.
Save your changes.
(Optional) Block your other WordPress extensions
The Axeptio extension for WordPress was developed to allow blocking filters and shortcodes that plugins may use. In short, if you use a Google Analytics plugin for WordPress, it will inject JavaScript and add code to your WordPress project. This is what our extension blocks.
When extensions are blocked, an additional screen is automatically added to your banner to list the services related to your extensions and submit them to consent.
The default configuration:
We have developed a plugin database to configure your plugin as best as possible without requiring additional configuration. You can find all these values in Axeptio > Extensions.
If an extension is checked:
It means we know it sends personal data and we have pre-blocked it from user consent. You can update this configuration by clicking "Edit"
If an extension is not checked:
Either it is unknown to our system and you can force the configuration by clicking the edit button then "Hooks and Shortcodes". Choose to block everything or you can specify the hooks more precisely.
Or it does not send personal data and in that case, no additional configuration is needed, it is a functional extension. Leave it unchecked.
Daily, we add new extensions to our vendors DB to better control the operation of extensions. Come back to the Axeptio plugin from time to time to see if there are new extensions that have been updated and are installed on your WordPress project. By clicking "Update", you will be able to retrieve our latest recommendations in terms of plugin configuration.
Next step: cookie blocking
To be compliant, you must still condition your cookies to consent, because Axeptio does not block them (except for those from services you have blocked from Axeptio > Extensions).
The use of our WordPress extension is fully compatible with the use of Google Tag Manager: this is actually the implementation we recommend!
On one side, the WordPress extension manages loading the banner on your site, as well as setting Google Consent Mode v2 signals (if applicable).
On the other side, GTM manages the consent conditioning logic through triggers.