Site Scan is a deprecated feature and is no longer offered or supported, but will remain functional for accounts that previously enabled it.

Table of Contents:

Using Site Scan

Using the Site Scan tool to crawl through your site and verify your Tealium tag implementation is a simple process.

  1. Create a scan.
  2. Run the scan.
  3. Review the scan's report.

To use the Site Scan tool, contact your Account Manager. We recommend that you perform an initial Site Scan to validate Tealium's code in your website. After that, only use Site Scan after a major site change.

Creating a Scan

To create a Scan:

  1. In Tealium iQ, navigate to the My iQ tab.
  2. Click the Site Map Scan tab in the side bar on the left.
  3. Click the Add Scan in the upper right corner.
  4. Click Next to proceed to the Site Maps tab.
  5. In order to run an scan, you must provide a site map listing the URLs you wish the tool to search through.
  6. Click Create Site Map.
  7. Enter a descriptive title between 3 to 30 characters long.
    You may use alphanumeric characters and spaces. This is a required field.
  8. In the URL field, enter the URL address of the site map.
  9. Click Save
  10. The Site Scan tool verifies that you entered a valid location for the site map.

    You may specify either a site map or a site map index.

  11. Click Save.
    Tealium validates the site map's URL.
    Invalid site map URLs will result in the following error message:
  12. Add as many site maps to the scan as necessary.
    Be aware that a site map can include pages that are managed by another Tealium profile.
  13. Select the site map(s) you want to include for this scan and click Finish.

Running a Scan

From the drop-down list, select the scan you wish to run and click Run

Any user can view a scan's report but only users with Publish to Prod permissions can run a scan. You cannot halt a scan mid-process. To halt a scan, contact your account manager.


Tealium processes only one scan at a time. Adding scans while one is running adds those scans to a queue for processing later. Scans process in the order in which they are received. Contact your Tealium Account Manager to cancel a scan. The time it takes to finish the scan depends on the number of URLs included in the site map(s). Scans require at least one site map to run. You cannot run a site scan without uploading a site map.

Site Map Parameters

Site Scan is only interested in two parameters from the the site map: the URL's location and the URL's priority. Site Scan will crawl through the URLs based on their assigned priority, starting with higher priority and moving to lower. Valid priority values range from 0.0 to 1.0, with 1.0 indicating the highest priority.


Reviewing the Report

Tealium's best practices indicate that when you use the Site Scan tool, you should perform an initial Site Scan. Perform additional site scans when your site undergoes a significant change. After the scan finishes, the latest report displays in the Site Scans section of the Reports tab. Click on the latest report to view the summary. 

Report Summary

The details for a report list the date you ran the scan, who received the notification email, the profile(s) the scan found, and the number of pages containing or missing Tealium's code.

  1. Click the Open Report to view the details.
  2. Click Delete to remove the report.

Report Columns

The following table describes the report columns for each scan:

Scan Description
DATE The date the scan started.
STATUS This column shows the status of a scan. The status displays as either 'Queued', the percentage of the scan completed, or 'Finished'.
TOTAL The total number of URLs Site Scan found in the site maps you provided.
MANAGED The number of pages that have the proper Tealium code included. The percent of total URLs is also included.
W/ UNMANAGED TAGS The number of pages with yags that are not managed through Tealium iQ.
UNMANAGED The number of pages that are missing Tealium's code. The percent of total URLs is also included.
ERRORS  The number of pages that returned a 404: Page Not Found error. The percent of total URLs is also included. 
 ADDED The number of new URLs since the last time you ran the scan. The first time you run a scan, this value will be zero.
REMOVED The number of URLs removed since the last time you ran the scan. The first time you run a scan, this value will be zero.

 Report Details

You can view the specifics of a report by clicking on the Open Report button. You can optionally filter the view to see only the changes that occurred since the last scan.

SiteScan_Reviewing Reports.jpg

Site Scan has the ability to detect unmanaged Tags and capture their configurations. To drop-down a list of unmanaged Tags, click the Tags not managed by Tealium iQ bar. If you want to manage any Tag from this list through Tealium iQ , click the Add button next to it.


To view a list of URLs for Pages not managed by Tealium iQ or Page could not be reached click the corresponding  bar.

SiteScan_View Site Map.jpg

 You can open the report for a scan that is still running, but be aware that not all of the data is available.

Considerations When Using Site Scan

Pages with Form Gates

Site Scan cannot check pages that have a form gate, i.e. a form that must be filled out by the visitor before he or she can proceed. Check these pages manually.

Non-Standard Implementation of Tealium's Code

If a page is using Tealium's code with a reference other than the standard utag.js file reference, that page will show up in the scan's report as missing the utag.js file.

Static vs. Dynamic Pages

Certain types of pages, particularly pages that are dynamically generated, such as thank you pages, may not show up on a site map. As a result, Site Scan does not check them. These pages require manual validation that Tealium's code is included. To check dynamic pages for unmanaged Tags, use the Scan Companion tool, available only for the Chrome browser.