Skip to main content
A unique Privy code must be installed on your WordPress.org website in order to display your displays and track your website events (e.g., display views).

​
Install via plug-in

The Privy plugin adds the Privy code to every page of your site, including your WooCommerce cart and checkout pages. It loads the code asynchronously by default, so it doesn’t hold up the rest of the page. It needs WordPress 6.3 or later. Follow the steps below to download and install the Privy plugin for WordPress.
  • Click here to download the WordPress Plugin and save it to your computer.
  • Upload the privy-wordpress-latest.zip file to your WordPress site. To do this, navigate to the Admin dashboard in your WordPress site and select Plugins > Add New from the sidebar. 
Screenshot showing how to add a new plugin within wordpress
  • On the subsequent screen, select the Upload option. 
Screenshot pointing out where to upload your Privy plugin
  • Once the upload is complete, click Activate Plugin to activate the plugin on your site. It’s listed as Privy Website Widget in your plugins.
Screenshot pointing out where to Activate your Privy Plugin on wordpress
On a WooCommerce store, you can skip the account identifier steps below. In WordPress, go to Settings > Privy and click Connect to Privy. When your store connects, Privy fills in your account identifier. See Connect your store.
  • Navigate to the Privy Code page in your account’s Settings.
  • Locate and copy the code listed in the Your Account Identifier section, as shown below:
Screenshto showing where to locate your Privy account ID from your Privy Code settings page
  • In WordPress, go to Admin dashboard > Settings > Privy, enter the account identifier, and click Save Changes.
And that’s it! Now, your site will display any display where the plugin/widget is active.   The plugin loads the code asynchronously. To load it before the rest of the page instead, select Synchronous on the same settings page and click Save Changes.

​
Install the code manually

If you’d rather not use the plugin, you can add the code to your theme yourself by following the steps below:
  • Navigate to the Privy Code page in your account’s Settings.
  • Locate and select the Default or Asynchronous tab to reveal its details. The default code is the preferred method to install Privy, allowing it to load in line with everything else on your site. Meanwhile, the asynchronous code will load Privy last. 
  • Copy the selected code.
  • Log in to your WordPress account.
These steps are for classic themes. For a block theme, or to add the code without editing theme files, see Install without the plugin.
  • In the left sidebar menu, navigate to Appearance > Theme File Editor.
Screenshot showing where to access the site editor in Wordpress
  • In the list of theme files on the right side of the editor, select your Theme Header.
Screenshot showing where to access the Theme Header from within the Wordpress site editor
  • Scroll to the bottom of the file, paste in the tracking code, and select Update File. If you are running a caching plugin, you must clear your cache now in that plugin’s settings.
Screenshot showing where to update your Wordpress site file with your Privy code

​
Verify the installation

The Privy code allows you to display your displays and monitor your website’s events (e.g., display views). If your displays aren’t displaying properly or event information is missing, verify that the code has been installed and that it’s firing correctly:
  • Navigate to the Privy Code page in your account’s settings.
  • In the Installation Guides section, locate and copy your Account Identifier. 
  • Open a page on your website and right-click anywhere on the page.
  • In the dropdown menu, select View page source or View source.
  • Use CTRL-F or CMD-F to search for the identifier that you copied.
Screen recording showing where to locate your Privy code within your site
  • If the code appears, verify that it has been copied and pasted correctly from your settings.
If the Privy code does not appear or is incorrect, follow the instructions under the Plug-In section of this article to install it properly. If your code appears and has been copied and pasted correctly, verify that it’s firing: 
  • Open a page on your website and right-click anywhere on the page.
  • In the dropdown menu, select Inspect Element or Inspect. A toolbar will appear at the bottom or side of your screen.
  • Click the Network tab, then refresh your page. 
  • Click the Name column to sort the elements alphabetically, then look for widget_.js_. 
  • Next to widget.js, you should see 304 Not Modified or 200 OK in the Status column.
Screenshot showing how the Javascript may appear in console If you see any other status or the .js code is not found, your tracking code may not be firing correctly. Contact Support for further troubleshooting steps and assistance.