Troubleshooting & Support

Common Issues

❌ Widget Not Showing

Possible Causes:

  • JavaScript is disabled in browser

  • Incorrect project slug

  • Script placed in wrong location

  • Ad blocker is interfering

Solutions:

  1. Check JavaScript - Ensure JS is enabled in browser settings

  2. Verify project slug - Confirm it matches your audit URL exactly

  3. Move script location - Place script in <body> section, not <head>

  4. Test in incognito - Try private browsing to bypass ad blockers

Examples:

<!-- ✅ Correct placement -->
<body>
  <p>Your content here</p>
  <script src="https://api.tokenomics.com/v1/widget/embed.js" 
          data-project-slug="your-project-slug" 
          async></script>
</body>

<!-- ❌ Wrong placement -->
<head>
  <script src="https://api.tokenomics.com/v1/widget/embed.js" 
          data-project-slug="your-project-slug" 
          async></script>
</head>

❌ Widget Shows Loading Forever

Possible Causes:

  • Project slug is incorrect

  • Project hasn't been audited yet

  • Website not whitelisted to display widgets

Solutions:

  1. Verify your project slug is correct

  2. Confirm your project audit is complete

  3. Make sure your website is whitelisted to display the widget (Contact us on Telegram)

Finding Your Correct Project Slug

Your slug is the last part of your audit URL:

https://tokenomics.com/audits/ondo-finance
                              ^^^^^^^^^^^
                              Your slug

❌ Overlay Display Issues

Possible Causes:

  • CSS z-index conflicts with your website elements

  • Fixed position elements covering the widget

  • Multiple widgets too close together

Solutions:

  1. Check z-index - Ensure no elements near the widget have z-index values above 9999

  2. Adjust container styles - Add position: relative; z-index: 1; to the widget container

  3. Space widgets - Add more vertical space between multiple widgets

  4. Custom fix - For severe issues, wrap the widget in a div with higher z-index:

<div style="position: relative; z-index: 2;">
  <script 
    src="https://api.tokenomics.com/v1/widget/embed.js" 
    data-project-slug="your-project-slug" 
    async>
  </script>
</div>

❌ Widget looks broken or misaligned

Possible Causes:

  • CSS conflicts with your site styles

  • Content Security Policy blocking styles

  • Theme doesn't match your background

  • Scale values too large for container

Solutions:

  1. Try different theme - Switch between light and dark

  2. Adjust scaling - Use smaller data-scale values (0.3-0.5 recommended)

  3. Check CSP - Add required CSP directives (see Technical Requirements)

  4. Test isolation - Try widget on a blank HTML page

Examples:

<!-- Try smaller scale -->
<script 
  src="https://api.tokenomics.com/v1/widget/embed.js" 
  data-project-slug="your-project-slug"
  data-theme="dark"
  data-scale="0.4" 
  async>
</script>

❌ Widget doesn't work properly on mobile

Solutions:

  1. Reduce scale - Use smaller data-scale value for mobile (0.2-0.3 recommended)

  2. Adjust expanded scale - Make hover card smaller with data-expanded-scale="0.5"

  3. Test touch interaction - Ensure tap works like hover on mobile

Examples:

<!-- Mobile-optimized settings -->
<script 
  src="https://api.tokenomics.com/v1/widget/embed.js" 
  data-project-slug="your-project-slug"
  data-scale="0.3"
  data-expanded-scale="0.5" 
  async>
</script>

Contact Options

🔄 Immediate Help

📧 Email Support

📋 Feature Requests

PreviousCustomization Options

Last updated