search

Troubleshooting & Support

hashtag
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 Telegramarrow-up-right)

hashtag
Finding Your Correct Project Slug

Your slug is the last part of your audit URL:

❌ 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:

❌ 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:

❌ 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:

hashtag
Contact Options

🔄 Immediate Help

📧 Email Support

📋 Feature Requests

PreviousCustomization Options

Last updated