How-tos
Fix: player not showing
If the GSpeech player does not appear on a page, walk this checklist top to bottom. Most “missing player” cases are connection, publish status, Render Element, or URL rules — not a broken voice.
- Why useful — one ordered path instead of guessing across docs.
- Start simple — Cloud connection and Published status fix most sites.
- Then selectors / URLs — Render Element must exist on the page; Allowed / Blocked must allow it.
Open Cloud Console
Multi-Page how-to
All How-tos
Checklist
Check in this order
- Connection code live — the site embed / plugin / CMS connection is on the page (WordPress Cloud activated, or HTML script before </body>).
- Widget Published — Multi-Page and RHT are published by default after Cloud activation. Shortcodes are ready but need the shortcode pasted. Welcome stays disabled until you enable it. Custom widgets must be Published.
- Hard-reload — bypass browser cache (and bump v_ind on custom HTML embeds if you use that cache pattern).
- Render Element matches the page — Multi-Page defaults cover common wrappers; custom themes need your real class/ID. Custom mounts need .gsp_full_player / button / circle on the page.
- Allowed / Blocked Urls — empty Allowed = all matching pages; if Allowed has lines, the current URL must match; Blocked must not match.
- Right page type — shortcode only appears where you pasted it; Multi-Page only where Render Element exists.
By type
Quick hints per player
- Multi-Page — no shortcode; fix Render Element / URL rules. See Multi-Page how-to.
- Shortcode — paste [gspeech] / button / circle in the editor; widget must exist (created on activation).
- Custom mount — empty mount in layout + Render Element = that class. See custom widget how-to.
- RHT — no mount; select text on the live page. Published by default after activation.
- Welcome — disabled by default; enable / publish when you want the greeting.
FAQ
Player not showing FAQ
-
Compare Render Element markup and Allowed / Blocked Urls between the two URLs. Themes often use a different content wrapper on homepage vs posts.
-
That is Content Selector / Exclude — not “missing player.” See
Exclude List & nospeech.
