> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/extensions/plugins/wordpress-plugin.md).

# Wordpress Plugin

Install and validate AdPage Tagging for your WordPress site.

Use the AdPage Tagging WordPress plugin to track supported form submissions.

<a href="https://is.wordpress.org/plugins/tagging/" class="button primary" data-icon="wordpress">Install from WordPress.org</a>

### Before you start

Have access to your WordPress admin and Google Tag Manager container. Remove duplicate form tracking before testing the plugin.

The plugin supports Contact Form 7 and Gravity Forms.

### Install the plugin

{% stepper %}
{% step %}

#### Install AdPage Tagging

Open the plugin listing and select **Download**. In WordPress, go to **Plugins → Add New → Upload Plugin**. Upload and activate the plugin.
{% endstep %}

{% step %}

#### Complete the plugin setup

Open the AdPage Tagging settings in WordPress. Complete the required setup for your website.
{% endstep %}

{% step %}

#### Publish your changes

Save the plugin settings and publish your Google Tag Manager container. Use preview mode before publishing production changes.
{% endstep %}
{% endstepper %}

### Validate the installation

Use Google Tag Manager Preview to test your website. Submit a supported form during one test session.

Confirm the `trytagging_generate_lead` event appears in the data layer. Check that the event contains the expected form fields.

See [generate\_lead dataLayer (Contactform7 & GravityForms)](/integrations-websites/woocommerce/generate_lead-datalayer-contactform7-and-gravityforms.md) to turn this event into a GA4 conversion.

### Available WordPress events

The plugin sends this event when a supported form is submitted:

* `trytagging_generate_lead`

The event includes submitted form data in `form_data`. Field names depend on your form configuration.

{% hint style="warning" %}
Do not submit real customer data while testing. Use a test form and test contact details.
{% endhint %}

### Troubleshooting

If the event does not appear, confirm the plugin is active. Then check that the submitted form uses Contact Form 7 or Gravity Forms.

If events duplicate, disable overlapping form or tag-manager integrations. Retest in an incognito window after clearing site data.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.adpage.io/extensions/plugins/wordpress-plugin.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.