Troubleshoot tracking issues

If DAVE reports missing attributes, can’t find expected elements, or returns results that don’t match the page, you can use its built-in tools to investigate and resolve the issue.

Debugging tools

Log an element in the browser console

Some checks in DAVE include logging the related element to the browser console so you can inspect it directly in DevTools. This helps with:

  • Confirming whether an attribute is truly missing versus just difficult to find.
  • Verifying the attribute exists on the correct element (e.g., container, item tile, button, etc.).
  1. Open console tools.
  2. Launch DAVE from your browser toolbar.
  3. Navigate to the correct page type.
  4. Select the console icon to the right of the desired element name.
  5. Review whether elements contain the expected data-cnstrc-* attributes and values.

Highlight elements

Enable the Highlight all elements setting to visually confirm element assignments. This helps with:

  • Confirming DAVE is targeting the same UI component you expect.
  • Spotting cases where markup exists but is attached to a wrapper element you did not intend.

Show hidden elements tooltips

Enable the Show hidden elements tooltips setting to visually confirm hidden elements (drawers, off-screen carousels, collapsed panels, etc.). This helps with:

  • Diagnosing “it exists in code but not on the page” scenarios.
  • Avoiding false assumptions when the element is present but hidden by CSS/state.

Resolve common issues

Catalog elements are not showing

Some validations can depend on DAVE detecting the correct index key. If the index key is missing or incorrect, then checks may fail or appear incomplete. Learn how to update the key, or follow the steps below.

Steps:

  1. Launch DAVE from your browser extension menu or bookmarks bar.
  2. Select the gear icon in the top-right corner of the extension window.
  3. Locate the Index Key field at the top of the extension window.
  4. If the index key is missing, enter the correct index key for the site.
  5. Select Save.

If it still fails:

  • Confirm the environment is correct (i.e., production vs. staging can use different index keys).
  • Confirm the page has fully loaded.
  • Confirm whether populated item IDs exist in the synced catalog

DAVE says an attribute is missing, but you can see it in the DOM

This can happen if the attribute is on a different element than DAVE expects, or the page context is not what DAVE detected.

Steps:

  1. Use DAVE’s Log element tool (if available) to jump to the targeted element.
  2. In the DevTools Elements section, verify:
    • The attribute name is correct (e.g., spelling, dashes, prefix).
    • The attribute is on the correct element (e.g., container vs. item vs. button).
  3. Confirm you are validating the correct page type:
    • Search results page vs a “search-like” listing page.
    • Browse category page vs a static collection page.

DAVE cannot find Autocomplete or Recommendations

These UI modules might be lazy-loaded, gated behind consent, rendered only after interaction, or loaded in an iframe or shadow DOM (implementation-dependent).

Steps:

  1. Make the module visibly render first:
    • For Autocomplete, select the search input, begin typing, and ensure suggestions appear.
    • For Recommendations: Scroll to the module and wait for it to populate items.
  2. Re-launch DAVE and validate again.
  3. If your site uses consent banners, accept consent and refresh.

If it still fails:

  • Try enabling Show hidden elements tooltips to see if the module is present but hidden.
  • Confirm ad blockers or privacy extensions are not blocking scripts.

Results differ between staging and production

It is common for DAVE to show different results between staging and production, even when the pages look similar. Small differences in build versions, feature flags, consent tooling, third-party scripts, or environment-specific configuration can change what is rendered in the DOM, which changes what DAVE can detect and validate.

Steps:

  1. Confirm you are using the correct environment URL.
  2. Confirm the same frontend build is deployed.
  3. Clear cache and do a hard refresh.
  4. Validate the same page path with the same user state.

Escalate issues to Constructor

Before reaching out, run through this quick checklist to make sure DAVE is validating the page in the right state and that the issue is reproducible:

  • Confirm the page is fully loaded and the relevant UI is visible (e.g., autocomplete is open, recommendations have rendered).
  • Confirm the index key is detected or correctly set.
  • Verify the attribute on the rendered DOM in Chrome DevTools (not only in templates or source code).
  • Re-test with blockers turned off, including ad blockers and script blockers.

When requesting help, include:

  • The page URL (or step-by-step reproduction instructions).
  • Which DAVE section failed (e.g., Search, Browse, PDP, Autocomplete, Recommendations, etc.).
  • Screenshot(s) of the DAVE output (or the exported report).
  • The extension version from the Settings menu.