DNI script 101: how to install and configure it
Setting up Dynamic Number Insertion (DNI) involves configuring your account first, then publishing the script to your website. Complete the steps below in order.
The 5-step setup process
Before your script can go live, you must complete the account configuration workflow.
Step 1. Acquire your tracking number
- Go to Tracking > Numbers.
- Click + Add.
- Choose the source you want to track.
- Pick a number type (Local or Toll-Free).
- Select a number from the list.
![]()
Detailed Guide: How to add your first tracking number
Step 2. Name your tracking number
- Give your number a descriptive name.
- You can set this during setup or later by clicking the edit (pencil) icon next to any number in Tracking > Numbers.
Step 3. Add a destination number
- Go to Tracking > Destinations.
- Click + Add.
- Enter the phone number where calls should be forwarded.
- This is where your business receives the call.
Detailed Guide: How to add a destination number
Step 4. Set up a call flow
- Go to Tracking > Call Flows.
- Create a new call flow using the Simple Call Flow template.
- Select your Destination Number and save.
- Then go back to Tracking > Numbers.
- Assign the call flow to your tracking number.
Detailed Guide: How to set up call flows
Step 5. Test your setup
- Dial the tracking number from your mobile phone and confirm it rings at your destination.
- Then, check Activity > Calls to verify the test call appears in your logs.
Publishing the DNI Script
Once your account is configured (all five steps above are complete), you're ready to go live.
Step 6. Open the script page
Go to Tracking > Tracking Code in Nimbata.
Step 7. Configure your swap targets
This is the most critical step.
You need to tell Nimbata which phone number on your website to replace.
- Auto-detection: Nimbata can scan your page automatically.
- Span tag (recommended for accuracy): Wrap your website number in a span tag:
<span class="nimbata">123-456-7890</span>

You can also toggle additional options here, such as Single Page Application (SPA) support or adjusting the cookie duration.
Detailed Guide: How to set up span tag
Step 8. Publish the script
Click Save & Publish, then add the script to your site using one of these methods:
Google Tag Manager: Paste the script into a Custom HTML tag.
See How to activate the DNI script via Google Tag Manager
WordPress: Install the Nimbata Plugin.
See How to activate the DNI script via WordPress
Manual HTML: Paste the script just before the </body> tag on every page.
See How to activate the DNI script via HTML

Verifying the Installation
- Live test: Visit your site; if you're tracking all channels, the number should swap immediately.
- Google Ads test: Visit
www.yoursite.com/?gclid=testto force a swap for paid search numbers. - Built-in checker: Use Nimbata's website URL checker, located just below the DNI script in Tracking > Tracking Code.
🎉 Numbers swapping correctly? You're live. Next, consider setting up swap groups if you want to track multiple numbers or channels independently.
Detailed Guide: How to set up swap groups
Troubleshooting: Why are numbers not swapping on my website?
Updated on: 30/03/2026
Thank you!