> ## Documentation Index
> Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wordpress

> Target specific visitors with a survey on your WordPress page using Formbricks for free. Show survey on specific page or on button click.

To run a targeted survey on your WordPress website, Formbricks is the way to go! 

With our generous free plan and open source tech, you get everything you need to get started and keep full control over your data.

## TLDR

1. Install the Formbricks WordPress plugin

2. Create a [free Formbricks account](https://app.formbricks.com/auth/signup)

3. Find and copy the `workspaceId`

4. Copy the `workspaceId` into the right field in the plugin settings

5. Create survey on trigger “New Session” to test it

## Step 1: Install the Formbricks WordPress plugin

As long as the Formbricks plugin is in review, please download it from our [GitHub repository directly.](https://github.com/formbricks/wordpress)

![Run targeted website survye on any WordPress site](https://mintcdn.com/formbricks/ciPr-k8rsK4LGtZI/images/platform/features/integrations/wordpress/1-wordpress-targeted-survey-on-website-free.webp?fit=max\&auto=format\&n=ciPr-k8rsK4LGtZI\&q=85\&s=a76bfff14611e37fb3023d650d0ae2b3)

## Step 2: Create a Formbricks Account

This is super straight forward: Go to [app.formbricks.com/auth/signup](https://app.formbricks.com/auth/signup), create the account, verify your email and you’re in!

When you see this screen, you’re there:

![Free HotJar survey alternative open source](https://mintcdn.com/formbricks/ciPr-k8rsK4LGtZI/images/platform/features/integrations/wordpress/2-run-website-survey-wordpress-targeted-for-free.webp?fit=max\&auto=format\&n=ciPr-k8rsK4LGtZI\&q=85\&s=cddb18fcbe224e74543aac7dddd71456)

## Step 3: Find and copy the workspaceId

Go to **Settings → Workspace → Web & Mobile SDK** where the **Workspace details** card holds your workspaceId:

![The Workspace details card on the Web & Mobile SDK settings page, showing Your Workspace ID and SDK Connection URL](https://mintcdn.com/formbricks/AHOlYlDNSsZMoYm0/images/platform/features/integrations/wordpress/3-wordpress-setup-survey-on-website-targeted-free-open-source.webp?fit=max\&auto=format\&n=AHOlYlDNSsZMoYm0\&q=85\&s=a70da295a6ee59caf6d6bd3e98028fb9)

## Step 4: Copy the workspaceId to the WordPress Plugin Settings

In your WordPress instance, go to the Formbricks Plugin settings and copy the workspaceId in the correct field:

![Free and open source HotJar survey on WordPress page](https://mintcdn.com/formbricks/ciPr-k8rsK4LGtZI/images/platform/features/integrations/wordpress/step-4-copy-to-wordpress-for-free-targeted-survey.webp?fit=max\&auto=format\&n=ciPr-k8rsK4LGtZI\&q=85\&s=8c8fa8dcc10669cd6a90528a7fb18d68)

Then click the button at the bottom to see if the connection worked.

> [!NOTE]
>
> If you don’t use our Cloud, you also have to update the API Host

Great!

## Step 5: Create survey on trigger “New Session”

Now that all is setup, we create a survey to display an example survey. Create a survey and open survey editor.

Keep the content for now, click on the Settings tab:

![Free and open source HotJar survey on WordPress page](https://mintcdn.com/formbricks/ciPr-k8rsK4LGtZI/images/platform/features/integrations/wordpress/4-wordpress-website-survey-target-visitor-free.webp?fit=max\&auto=format\&n=ciPr-k8rsK4LGtZI\&q=85\&s=80afd3b6226a90a41d3f03cdbba06ae3)

Here we do three things:

1. Change survey type to **App Survey** or **Website Survey**(for public facing)

2. Select trigger “New Session”

3. Publish

![Open Source survey on targeted website wordpress](https://mintcdn.com/formbricks/ciPr-k8rsK4LGtZI/images/platform/features/integrations/wordpress/6-targeted-survey-on-wordpress-website-for-free.webp?fit=max\&auto=format\&n=ciPr-k8rsK4LGtZI\&q=85\&s=8fe522da324ec001cafd5ef27f88125c)

When you see this page, you did it!

![Run free an open source targeted survey on any page](https://mintcdn.com/formbricks/ciPr-k8rsK4LGtZI/images/platform/features/integrations/wordpress/7-wordpress-free-hotjar-survey-open-source-website-survey-hotjar.webp?fit=max\&auto=format\&n=ciPr-k8rsK4LGtZI\&q=85\&s=e81b1d8f9fa9b3b3e77fdaf9188c7cbc)

## Step 6: Reload your page to check out your survey 🤓

You did it! Reload the WordPress page and your survey should appear!

## Doesn't work?

If you have any questions or need help, feel free to reach out to us on [Github Discussions](https://github.com/formbricks/formbricks/discussions)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.