Installing CallRail's WordPress Plugin

CallRail’s easy-to-install WordPress call tracking plugin allows you to dynamically swap the phone number displayed on your website and to track form submissions. Each company in your account has its own unique token you’ll use when installing the plugin to your WordPress website. Please note that if you install the plugin, you do not need to install the JavaScript snippet; the plugin automatically installs the JavaScript snippet on every page of your website. 

Each tracking number you create can be assigned a source (like Google Ads, Bing Organic, Yelp, Facebook, etc.) and the correct tracking number will display when a user reaches your website via one of those sources. You'll also be able to track any form submissions on your website by enabling external form tracking or adding a custom form.

Getting Started

There are a few important details you’ll need to know before you get started with the WordPress plugin:

  1. Once you’ve installed the plugin on your website, be sure to test your installation before your campaign begins.

    Learn how to test dynamic number insertion with this help article

  2. Our plugin detects multiple number formats, including:
    111-222-3333, 111.222.3333, and (111) 222-3333.

  3. Special steps are necessary to swap phone numbers in images.

    Learn more about image swapping with this help article

  4. The WordPress plugin automatically installs CallRail’s JavaScript snippet on every page for you. The snippet must be embedded on the visitor’s landing page, as well as each page on your website that displays a phone number. 

  5. To begin tracking form submissions with CallRail, you will need to enable external form tracking for your company or create a custom form. 

    Learn more about enabling Form Tracking with this help article

Our WordPress plugin runs as a first-party script by default once it's been installed on your website since we provide first-party tracking and not third-party tracking. This allows your plugin to function as expected for website visitors who may be using a particularly sensitive ad blocker on their browser.

Installing the WordPress Plugin

The WordPress plugin you'll use for your website is company-dependent within your account. Use these instructions to learn how to upload the WordPress plugin for a specific company.

  1. Click the Settings icon on the left navigation bar.

  2. Choose the company whose plugin you'd like to activate.

  3. Click Integrations at the top of the page. 

  4. Click on the WordPress tile to show those instructions.

  5. Open a separate browser tab and log into your WordPress account.

  6. Within Wordpress, select Plugins, then search for CallRail

  7. When you have located the CallRail plugin in Wordpress, click Install Now and then Activate.

  8. Once your plugin is successfully installed, select Settings in the left menu, then click CallRail.

  9. Add the WordPress plugin key from the Integrations page within CallRail to the plugin settings in WordPress. 


  10. Click Save Changes to activate your plugin.


Why isn’t my telephone number swapping?

Have you cleared your cookies, or tried accessing the website in a private browsing session? The most important part of testing dynamic number insertion is to simulate the experience of a first-time visitor before testing. Otherwise, the swap code will detect you as a visitor to the website from a previous session.

Learn more about testing dynamic number insertion with this help article

How do I prevent a number from swapping on my website?

If there is a specific place on your website where you don't want the number to swap, update the telephone number in your source code so that our swap script doesn't recognize it. In the number that you do not want to be swapped, you can use HTML tags that don't apply additional style.

For example: 555-<span>444<span>-3333.

When setting this up, we recommend placing "<span>" within the middle of the phone number (as illustrated above). With those additional HTML tags, our JavaScript file will not find/swap the number that you'd like to appear static.

Do I need to remove the JavaScript snippet if I disable call tracking?

CallRail’s JavaScript code is company-specific. If you don’t plan on creating new tracking numbers in the same company where your tracking number(s) has been disabled, you can safely remove the WordPress plugin. However, if you leave the plugin on your website, the numbers will no longer swap since those numbers have been disabled. If you want to continue tracking forms, do not remove the JavaScript snippet. 

Can I have a white-labeled version of my plugin?

Yes. Use the instructions above when logged into CallRail via your white label domain to access a white label version of your plugin.

Why don't I see tracking data for incoming form submissions from an external form?

Use this help article to troubleshoot external form submissions.