Trade-In Tool Troubleshooting

Support topics:

 

The widget will not load on a dealer site

Each Edmunds Trade-in/ICO Widget installation requires two specific HTML tags, as described in your original installation instructions. If either tag is missing or malformed, the widget will not load.

Be sure to follow HTML standards when inserting these tags. For instance, Microsoft "smart" quotation marks or extra spaces within the tags can cause rendering issues.

The Edmunds Unified Container script tag (for Trade-In/ICO)
Make sure the page has one — and only one — copy of this tag in the HTML <head> section, or wherever "raw HTML widgets" are installed on the site:

<script async src="https://content-container.edmunds.com/{DealerId}.js" type="text/javascript"></script>

The {DealerId} value must match the dealership's unique Dealer ID value. This unique value can be found in the original installation instructions. For example, a Dealer ID of "12345" would require a script tag like this:

<script async src="https://content-container.edmunds.com/12345.js" type="text/javascript"></script>

The script tag will only work if the site domain has been associated with the Dealer ID value. To confirm a site domain association or request a Dealer ID for a test site domain, send an email to webtools@edmunds.com.

The Edmunds Trade-in Widget div tag
Make sure the page has one — and only one — copy of this tag in the HTML <body> section:

<div class="edmunds-trade-in"></div>

The tag may also contain an optional data-display attribute, as in this example:

<div class="edmunds-trade-in" data-display="standard-autocomplete"></div>

The Edmunds ICO Widget div tag
Make sure the page has one — and only one — copy of this tag in the HTML <body> section:

<div class="edmunds-instant-offer"></div>

The tag may also contain an optional data-display attribute, as in this example:

<div class="edmunds-instant-offer" data-display="standard"></div>

The widget will not load/work on a Single-Page Application (SPA) dealer site

Follow these steps/precautions to help address this issue:

  1. Ensure the Edmunds Trade-in/ICO Widget div tag is always present in the <body> tag at the desired location relative to the rest of the page, even after SPA navigations — before the Widget script tag is (re)inserted.
    • If possible, to ensure this: hardcode the div tag on the server-side HTML. (I.e., it should be present when searched for via the browser "View Page Source" context menu or view-source:https://yoursite.com in the address bar.)
  2. After every SPA navigation where the Widget will not consistently load/work properly: Re-inject the respective Trade-in/ICO Widget script in the HTML <body> section, to force re-populating the corresponding Widget div tag:
    • Trade-in Widget: <script defer="defer" type="text/javascript" src="https://trade-in.edmunds.com/static/js/edm-eva.js"></script>
    • ICO: <script defer="defer" type="text/javascript" src="https://trade-in-offers.edmunds.com/static/js/edm-ico.js"></script>

The installation looks correct, but I still can't see the widget

When the widget loads, its HTML markup will appear inside the Trade-in/ICO Widget div tag. Therefore, the tag must be placed in a user-visible area of the HTML <body> section, or it will be hidden.

One data-display attribute value, "no-banner-overlay", hides the widget even when installed correctly. Additional work is necessary to make this version of the widget visible. For help setting up the "no-banner-overlay" variant, reach out to the Edmunds Implementation team at webtools@edmunds.com.

The widget still won't load, or loads intermittently

If you have followed the above steps without success, or the widget is loading intermittently, we are here to help. Reach out to the Edmunds Implementation team at webtools@edmunds.com.

The widget loads, but I expected a banner

The Edmunds Trade-in/ICO Widget has several display variations, each optimized for a specific page type, as described in the original installation instructions. These variations are activated through the "data-display" tag attribute. If the wrong attribute value is used, the widget may not appear as expected.

Sample banner placements are available at our demo site:

Supported data-display tag attribute values are:

  • Trade-in Widget:
    • "standard-trigger": a click-triggered banner widget
    • "standard-autocomplete": an autocomplete banner widget
    • "reduced-height-autocomplete": an autocomplete banner widget with reduced vertical height
    • "no-banner-overlay": a hidden widget instance that is exposed by an external CTA click
  • ICO Widget:
    • "standard": a click-triggered banner widget
    • "reduced-height-standard": a click-triggered banner widget with reduced vertical height
    • "banner-overlay": a widget with the first step directly shown, but subsequent steps in overlay
    • "hero": a widget that behaves like banner-overlay, but embedded in dedicated instant cash offer page
    • "hidden": a hidden widget instance that is exposed by an external CTA click
    • "no-banner-overlay": Alias to "hidden" (not preferred; for backward-compatibility with Trade-in Widget)
    • "standard-trigger": a smaller, click-triggered banner widget (not preferred; for backward-compatibility with Trade-in Widget)

If you have any other data-display tag attribute value, update to a supported value or reach out to the Edmunds Implementation team at webtools@edmunds.com.

What if my site header (or other site elements) are covering part of the Edmunds Trade-In/ICO Tool widget?

Web pages are built with z-indexing rules to determine which element is visible when two elements occupy the same space. Floating "sticky" headers are typically assigned z-indexes that ensure the header covers the site's main content. If you install your Edmunds Trade-In/ICO widget banner within the site's main content, the Edmunds Trade-In/ICO Tool widget banner and overlay may be covered by your floating "sticky" header.

In this scenario, we recommend you install your Edmunds Trade-In/ICO Tool widget as hidden, placed outside of your site's main content, then in your site's main content create your own button that opens the Edmunds Trade-In/ICO Tool overlay. When opened by button click, the Edmunds Trade-In/ICO Tool overlay should now be fully visible.

Back to Top

Join Edmunds

Receive pricing updates, shopping tips & more!

Back to Top