Embedded Widget Not Showing on Site

Help
FAQ
Embedded Widget Not Showing on Site
Circular representation of the United States flag with red and white stripes and white stars on a blue field.
English
Table of Contents
h2
Example H2
h3
Example H3
h4
Example H4
h5
Example H5
h6
Example H6

Common Symptoms

  • The area where the widget should appear is completely blank
  • The widget shows a loading indicator but never fully loads
  • The widget appears on some pages but not on others
  • The widget was previously visible but has stopped displaying after a site update
  • The widget does not appear on certain browsers or devices

Checklist: Things to Verify

The Firework widget can be embedded on a wide range of platforms including WordPress, custom CMS, and others. Please go through the following checklist to identify the cause.

1. Check that the script tag is placed correctly

Place the script tag just before the </body> tag, or in the <head> section if specified in the setup instructions. Verify that the script tag has not been accidentally removed or duplicated during recent site edits.

2.Check the widget visibility settings

In the Firework Business Portal, verify that the widget is set to "Published" or "Active," and that the display settings (such as scheduled dates or page targeting) are configured as expected.

3. Test in Incognito / Private Mode and other browsers

Open the page in Incognito or Private Mode, or try a different browser to check if the widget appears.

※ If the widget appears in a different browser or Incognito Mode, cache or cookies may be the cause. Try the next step.

4. Clear your browser's cache and cookies

Clear your browser's cache and cookies from the browser settings, then reload the page and check if the widget appears.

※ If your site uses a caching plugin or CDN, also clear the site cache.

5. Check for JavaScript errors in the browser console

Open your browser's developer tools and go to the Console tab. If there are any errors related to the Firework script, copy the error message and include it when contacting support.

If your site uses a CSP (Content Security Policy), it may be blocking the Firework script. Check your CSP settings and ensure that Firework's domains are allowed.

If the Issue Persists

If the widget still does not appear after going through the checklist above, please contact our support team with the following information:

  • The URL of the page where the widget is not showing
  • The type of platform or CMS you are using (e.g., WordPress, Shopify, custom HTML)
  • The browser and OS you used for testing (e.g., Chrome on Windows 11)
  • Any error messages shown in the browser console (screenshot or copy-paste)
  • Whether the widget was previously working, and if so, what changed recently
  • Steps you have already tried from the checklist above

‍