Media Guide
Use Media for one primary profile player. Keep it stable and embeddable first, then style it.
Fast path: set `Profile Song` URL -> choose display style -> set autoplay expectation -> verify on profile page.
Media Fields (Current Stack)
- Profile Song: URL field for embeddable media.
- Profile Music Display Style:
Minimal, Standard, Full-Featured. - Profile Music Autoplay:
Yes, No.
Media controls from your settings screen.
Autoplay reality: even with
Yes, browsers (especially mobile) may block autoplay until user interaction.
Supported Embed Paths In Current Logic
- YouTube:
youtube.com,youtu.be, and shorts/watch/embed URL forms. - SoundCloud: standard track URLs.
- Spotify: track/album/playlist URLs.
- Fallback: if URL is valid but not recognized, system prints a link instead of iframe.
Media Workflow
- Paste one public URL into Profile Song.
- Set Profile Music Display Style to Standard unless you need very compact or large presentation.
- Set Profile Music Autoplay (recommended default: No).
- Save and load actual profile page to validate embed rendering.
- If not rendering, test a known-good YouTube URL to isolate URL issue vs system issue.
Known-Good URL Patterns
YouTube: https://youtu.be/dQw4w9WgXcQ
Spotify playlist: https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M
SoundCloud track: https://soundcloud.com/artistname/trackname
Avoid: private links, non-share URLs, or URLs that require login to view; these often fail embed rendering.
Common Fixes
- No player appears: confirm URL starts with
https://and content is public. - Only link appears: URL is valid but not a recognized embed source pattern.
- Autoplay fails: browser policy blocked it; this is expected behavior in many clients.
- Layout too big/small: change display style (Minimal/Standard/Full-Featured).
- Page feels heavy: keep one media embed in this section and move extras to Advanced slots.
FAQs
What URL type should I use first?
Use a public, known-good URL from a supported source.
Why does autoplay fail even when enabled?
Browser autoplay policies often require user interaction.
Why do I only see a link and no player?
The URL is valid but not recognized as an embeddable source pattern.
How many embeds should I use?
Prefer one primary embed for reliability and performance.
Which display style is safest to start with?
Start with Standard, then tune Minimal or Full-Featured if needed.
What is the fastest troubleshooting step?
Test with a known-good YouTube URL to isolate URL issues.
