Embedding Troubleshooting

Having issues with embedding your TrackScore leaderboards? Find solutions to common problems and get your embeds working perfectly.

Quick Diagnostic Checklist

Before Troubleshooting

  • Verify your leaderboard ID is correct
  • Ensure the leaderboard is saved and published
  • Check that your website allows iframe embedding
  • Test the embed URL directly in a browser

Test Your Embed

Try accessing your embed URL directly:

https://trackscore.online/embed/YOUR_LEADERBOARD_ID

If this page loads successfully, the issue is likely with your embedding implementation.

Common Issues & Solutions

Iframe Not Loading

Possible Causes:

  • Incorrect leaderboard ID in the embed URL
  • Leaderboard is not saved or published
  • Network connectivity issues
  • Content Security Policy (CSP) blocking the iframe
  • Ad blockers or browser security settings

Solutions:

1. Verify Leaderboard ID

Check your leaderboard URL in the TrackScore dashboard and ensure you're using the correct ID in your embed code.

2. Update Content Security Policy

Content-Security-Policy: frame-src 'self' https://trackscore.online

3. Test in Incognito/Private Mode

This helps identify if browser extensions or ad blockers are causing issues.

Height Not Adjusting Automatically

Common with HTML Iframe Method

The basic HTML iframe method uses a fixed height. For dynamic height adjustment, use the JavaScript embed method instead.

JavaScript Solution:

<!-- Replace your iframe with this: -->
<div id="trackscore-leaderboard"></div>
<script>
(function() {
  var iframe = document.createElement('iframe');
  iframe.src = 'https://trackscore.online/embed/YOUR_ID';
  iframe.style.width = '100%';
  iframe.style.height = '600px';
  iframe.style.border = 'none';
  
  // Auto-resize functionality
  window.addEventListener('message', function(event) {
    if (event.origin !== 'https://trackscore.online') return;
    if (event.data.type === 'trackscore-resize') {
      iframe.style.height = event.data.height + 'px';
    }
  });
  
  document.getElementById('trackscore-leaderboard')
    .appendChild(iframe);
})();
</script>

Pro Tip: The JavaScript method automatically adjusts the iframe height based on the leaderboard content, providing a seamless user experience.

Styling Conflicts & Visual Issues

Issues You Might See:

  • Colors not matching your website theme
  • Fonts appearing different than expected
  • Spacing or layout inconsistencies
  • Elements overlapping or being cut off

Solutions:

1. Use Theme Customization

Try different themes to match your website's aesthetic:

?theme=corporate-clean - Professional appearance
?theme=cyberpunk - Modern, colorful design
?theme=sports-arena - Athletic styling

2. Transparent Background

Use transparent background to blend with your page:

?transparent=true&hideHeader=true&hideFooter=true

3. Adjust Container Styling

.leaderboard-container {
  border-radius: 8px;
  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
  overflow: hidden;
}
Slow Loading or Performance Issues

Optimization Tips:

1. Adjust Refresh Interval

For static content, disable auto-refresh or increase the interval:

?autoRefresh=false - Disable automatic updates
?refreshInterval=300 - Update every 5 minutes

2. Lazy Loading

Add loading="lazy" attribute to your iframe for better page performance.

3. Reduce Visual Elements

?hideHeader=true&hideFooter=true - Minimal UI

Browser Compatibility

Supported Browsers

✅ Fully Supported

  • Chrome 60+
  • Firefox 55+
  • Safari 12+
  • Edge 79+

⚠️ Known Issues

  • Internet Explorer: Not supported. Use Edge instead.
  • Older Mobile Browsers: Height adjustment may not work.

Advanced Troubleshooting

Developer Tools

Use your browser's developer tools to diagnose issues:

  • Console: Check for JavaScript errors
  • Network: Verify iframe source loads correctly
  • Elements: Inspect iframe dimensions and styling
  • Security: Look for CSP or mixed content warnings
Testing Tools

Test your embeds thoroughly:

  • Multiple Devices: Test on desktop, tablet, mobile
  • Different Browsers: Cross-browser compatibility
  • Network Conditions: Test on slow connections
  • Private/Incognito: Test without extensions
Still Need Help?

Contact Support

Our support team is here to help you resolve any embedding issues. Include details about your setup for faster assistance.

Premium Support

Premium users get priority technical support with faster response times and dedicated assistance for complex embedding scenarios.

Pro FeatureUpgrade for priority support

Related Documentation

Embedding Guide

Complete guide to embedding leaderboards on your website.

Customization

Learn about themes and appearance customization options.

API Reference

Advanced integration options using our REST API.