Title: Frequently Asked Questions
Author: staff
Published: August 1, 2022
Last modified: May 19, 2026

---

 1. [Installation resources](https://docs.parse.ly/installation-resources/)
 2. [Installation tools](https://docs.parse.ly/installation-resources/installation-tools/)
 3. [WordPress plugin](https://docs.parse.ly/installation-resources/installation-tools/wordpress-plugin/)
 4. Frequently Asked Questions

#  Frequently Asked Questions

## Getting started

### How does wp-parsely integrate with site pages?

The wp-parsely plugin sends tracking information for your traffic to Parse.ly’s 
servers and makes your pages and posts easily crawlable by the Parse.ly crawler.
The plugin:

 * Installs the Parse.ly `<script>` tag on every page of your WordPress site in 
   the footer section.
 * Maps various content properties from WordPress posts to appropriate fields in
   Parse.ly metadata. For example, the `title` of your post goes into the [Schema.org/NewsArticle](http://schema.org/NewsArticle)`
   headline` field, and the WordPress publication time of your post goes into the`
   datePublished` field
 * Understands your WordPress Category and Tag system, by mapping those to `section`
   and `keywords`, respectively.

### How can I verify that the Parse.ly tracker was installed successfully?

Review these [testing instructions](https://docs.parse.ly/installation-resources/parsely-integration/test-integration/)
to check tracker installation and page view events.

### How can I verify that wp-parsely outputs good metadata?

See the on-page metadata with the [Parse.ly](https://docs.parse.ly/validator/)[ ](https://docs.parse.ly/installation-resources/parsely-integration/test-integration/validator/)
[Validator](https://docs.parse.ly/installation-developer-resources/parsely-integration/test-integration/validator/)
or check out the [metadata ](https://docs.parse.ly/installation-developer-resources/parsely-integration/test-integration/how-to-check-metadata/)
[review](https://docs.parse.ly/installation-resources/parsely-integration/test-integration/how-to-check-metadata/)
[ guide](https://docs.parse.ly/installation-developer-resources/parsely-integration/test-integration/how-to-check-metadata/)
for step-by-step instructions of a Dashboard review.

### How can I see what has changed in the plugin?

The plugin follows [Semantic Versioning](https://semver.org/) for its release numbers.

To see the changes in each release, review the plugin’s [public changelog](https://github.com/Parsely/wp-parsely/blob/trunk/CHANGELOG.md).
Parse.ly recommends checking the changes of each version before upgrading.

## Customization

### Can I prevent the automatic insertion of the JavaScript tracker?

Yes, by setting the “Disable JavaScript” setting to `Yes...` in plugin [Basic settings page](https://docs.parse.ly/installation-resources/installation-tools/wordpress-plugin/#basic-optional-settings),
or by using the following filter:

    ```lang-php
    add_filter( 'wp_parsely_load_js_tracker', '__return_false' );
    ```

**Note**

The filter will override the respective setting on the settings page. To be able
to change the setting from within the settings page, remove this code.

### Can the rendered metadata be customized or disabled?

The rendered metadata (JSON-LD or repeated metas, depending on your configuration)
is customizable. Use the `wp_parsely_metadata` filter, which sends three arguments:
the array of metadata, the post object, and the `parsely_options` array:

    ```lang-php
    add_filter( 'wp_parsely_metadata', 'filter_parsely_metadata', 10, 3 );
    function filter_parsely_metadata( $parsely_metadata, $post, $parsely_options ) {
    	$parsely_metadata['articleSection'] = '...'; // Whatever values you want Parse.ly's Section to be.
    	return $parsely_metadata;
    }
    ```

This filter can go anywhere in your codebase, provided it always loads.

With this filter, use any of the following keys to go with `$parsely_metadata['Key']`:

 * `'@type'`
    - [Supported](https://docs.parse.ly/installation-resources/parsely-integration/metadata/metadata-jsonld/#h-type-values-that-parse-ly-recognizes-as-posts)
      [ post types](https://docs.parse.ly/installation-resources/parsely-integration/metadata/metadata-jsonld/#post-values)
    - [Supported non-post types](https://docs.parse.ly/installation-resources/parsely-integration/metadata/metadata-jsonld/#non-post-values)
 * `'@id'`
 * `headline`
 * `url`
 * `image`
 * `thumbnailUrl`
 * `articleSection`
 * `creator`
 * `author`
 * `publisher`
 * `keywords`
 * `dateCreated`
 * `datePublished`
 * `dateModified`
 * `custom_metadata`

To adjust a single piece of metadata, the following filters are also available:

 * `wp_parsely_post_tags`
 * `wp_parsely_post_type`
 * `wp_parsely_post_category`
 * `wp_parsely_pre_authors`
 * `wp_parsely_post_authors`
 * `wp_parsely_permalink`

To disable automatic metadata insertion completely, use:

    ```lang-php
    add_filter( 'wp_parsely_should_insert_metadata', '__return_false' );
    ```

### Can I disable parts of wp-parsely’s UI?

The following filters are provided to hide the _Open on Parse.ly_ link on the admin
bar and the posts list, respectively. If they return `false`, they won’t be rendered:

 * `wp_parsely_enable_admin_bar`
 * `wp_parsely_enable_row_action_links`

### Can I access the window.PARSELY object?

For some advanced integrations, you need to hook custom JavaScript code to some 
events on the `window.PARSELY` object. To do so, our plugin supports [WordPress JavaScript hooks](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-hooks/).
For example:

    ```lang-php
    $script = '
    window.wpParselyHooks.addAction("wpParselyOnLoad", "wpParsely", testFunc, 10);
    function testFunc() {
    	console.log("This is a hook");
    }';
    wp_add_inline_script( 'wp-parsely-loader', $script );
    ```

## Third-Party and Feature Support

### Is wp-parsely compatible with WordPress Network (Multisite)?

The wp-parsely plugin supports [WordPress Networks](https://developer.wordpress.org/advanced-administration/multisite/create-network/),
and it can be installed individually on each site or installed network-wide. The
latter method is recommended to avoid version conflicts and duplications.

Regardless of how the plugin is installed, it must be configured for each site. 
You must go to each subsite’s Parse.ly wp-admin page and set up its individual Site
ID.

### Is wp-parsely compatible with the Co-Authors Plus plugin?

Yes! If you have [Automattic’s Co-Authors Plus](https://wordpress.org/plugins/co-authors-plus/)
plugin installed, wp-parsely will automatically return a list of authors as metadata
instead of a single author.

### Does wp-parsely support tag managers?

Yes. Parse.ly works with tag managers like [Google Tag Manager (](https://docs.parse.ly/google-tag-manager/)
[GTM](https://docs.parse.ly/installation-resources/installation-tools/google-tag-manager/)
[)](https://docs.parse.ly/google-tag-manager/). Using both is advantageous as the
plugin provides metadata and [Content Intelligence](https://docs.wpvip.com/parse-ly/parsely-features/content-intelligence/)
features whereas tag managers are best for consent management. In that case, you
may disable the loading of the script by adding the following WordPress filter to
your codebase:

    ```lang-php
    add_filter( 'wp_parsely_load_js_tracker', '__return_false' );
    ```

Alternatively, disable the JavaScript tracker through the [Basic settings page](https://docs.parse.ly/installation-resources/installation-tools/wordpress-plugin/#basic-optional-settings).
Disabling it through the UI will have the same effect as the filter above. If you
are a WPVIP CMS customer needing additional help, Parse.ly Support can disable the
JavaScript tracker.

[Verify that the tag manager loads the Parse.ly tracker script.](https://docs.parse.ly/installation-resources/parsely-integration/test-integration/)
Tracking won’t work otherwise.

### Should I implement the Parse.ly tracker with wp-parsely or Google Tag Manager?

Determining which installation tool to serve the tracking code depends on your existing
setup and your future needs.

The WordPress plugin may be best for you if your site does not have an existing 
GTM container on your site and do not wish to add GTM to implement custom audience
segments and/or conversions.

Google Tag Manager may be best for you if you do have an existing GTM container 
on your site, and:

 * you have implemented other analytics platforms in GTM already,
 * you have a cookie consent banner integrated with GTM,
 * you plan to implement custom audience segments, or
 * you plan to implement conversions.

### Is wp-parsely compatible with AMP or Google Web Stories?

It is! The plugin hooks into Automattic’s official plugins for [AMP](https://wordpress.org/plugins/amp/)
and [Google Web Stories](https://wordpress.org/plugins/web-stories/).

AMP support is enabled automatically if the Automattic AMP plugin is installed.

### Does wp-parsely support Cloudflare?

When a website is running behind a Cloudflare DNS, their Rocket Loader technology
will alter how JavaScript files are loaded. [A JavaScript file can be ](https://support.cloudflare.com/hc/en-us/articles/200169436-How-can-I-have-Rocket-Loader-ignore-specific-JavaScripts)
[ignored](https://developers.cloudflare.com/speed/optimization/content/rocket-loader/)
[ by Rocket Loader](https://support.cloudflare.com/hc/en-us/articles/200169436-How-can-I-have-Rocket-Loader-ignore-specific-JavaScripts)
by using `data-cfasync="false"`. Legacy wp-parsely versions would mark all scripts
with this tag by default.

However, starting with wp-parsely version 3.0, that behavior must explicitly be 
enabled with the following filter:

    ```lang-php
    add_filter( 'wp_parsely_enable_cfasync_attribute', '__return_true' );
    ```

Last updated: May 19, 2026