Troubleshooting Common Hitz.FM Radio Widget Issues

How to Install the Hitz.FM Radio Widget in Minutes

1. Get the widget code

• Visit Hitz.FM’s widget page or your Hitz.FM account dashboard.
• Copy the provided HTML/JavaScript embed code (usually atag plus a ).

2. Choose where to place it

• Sidebar/footer: good for site-wide presence.
• Page body: good for a dedicated radio page.
• CMS-specific spots: use widget/HTML blocks in WordPress, Squarespace, Wix, etc.

3. Add the code to a plain HTML site

1. Open the HTML file for the page where you want the widget.
2. Paste the embed code where you want the player to appear (inside ).
3. Save and upload the updated file to your server.
4. Reload the page and test the player.

4. Add the code in WordPress

• Block editor (Gutenberg): add a “Custom HTML” block and paste the code.
• Classic editor: switch to “Text” view and paste the code where desired.
• Widget areas: Appearance → Widgets → Custom HTML → paste → Save.

5. Add the code in Squarespace / Wix / Shopify

• Squarespace: Use a “Code” block or inject into a page via Insert Point → Code.
• Wix: Add → Embed → Custom Embeds → Embed a Widget → paste code.
• Shopify: Online Store → Themes → Edit code (or use a Custom HTML section) → paste into the template or a custom section.

6. Mobile & layout adjustments

• If the widget has width/height attributes, set them to responsive values (e.g., width:100%).
• Wrap the code in a container div and use CSS to control max-width and alignment.

7. Fix common issues

• Player doesn’t appear: ensure script tag is allowed by your CMS and not blocked by CSP.
• Autoplay blocked: many browsers block autoplay with sound—enable muted autoplay or instruct users to click play.
• HTTPS mismatch: ensure widget URL uses https if your site is https.
• Conflicts with other scripts: try placing the widget code just before .

8. Test and verify

• Test in desktop and mobile browsers.
• Verify audio plays, controls work, and there are no console errors.
• Check load time; defer or lazy-load if it slows the page.

9. Optional: Styling & branding

• Use available widget options in Hitz.FM dashboard to change colors/skin.
• If only an iframe/container is provided, override simple styles via CSS targeting the container (if allowed).

If you want, I can produce the exact embed code sample and a short CSS snippet for responsive layout—tell me which platform you’ll install it on.