Tips and tricks
Control the Video Player with URL Parameters
Add supported query parameters to the generated iframe URL when one page needs playback behavior that differs from the stored player defaults. Keep the generated host and embed key unchanged, encode parameter values, and test the final URL in the actual page.
Example
https://dyn.tube/embed/video/YOUR_EMBED_KEY?playerId=dyntube-YOUR_EMBED_KEY&autoplay=1&muted=1&loop=1&t=9Muted autoplay is more widely accepted by browsers than autoplay with sound. Browser policy still decides whether playback may start, so keep a visible play control as the fallback.
Current video parameters
| Parameter | Purpose | Example |
|---|---|---|
| autoplay | Request playback on load | autoplay=1 |
| muted | Start with audio muted | muted=1 |
| loop | Restart after the video ends | loop=1 |
| t | Initial playback time in seconds | t=9 |
| quality | Initial quality preference | quality=auto or quality=720p |
| speed | Initial playback rate | speed=1.25 |
| captions | Caption preference supported by the embed | captions=1 |
| pip | Picture-in-picture preference | pip=1 |
| controls | Show or hide controls | controls=hidden |
| watermark | Viewer or session watermark text | watermark=Viewer%20123 |
| watermarkColor | Supported watermark color value | watermarkColor=%23ffffff |
| scheme | Player color-scheme preference | scheme=dark |
Build URLs safely
- Use URLSearchParams or your framework's URL tools rather than joining raw strings.
- Encode watermark text and never place secrets or unnecessary personal data in the URL.
- Keep signed playback parameters intact when adding presentation options.
- Use one stable playerId when attaching the v2 SDK to the iframe.
- Treat browser autoplay and picture-in-picture policies as runtime behavior to test.
Troubleshooting
If an option appears ignored, first test a fresh Dashboard-generated iframe with only that parameter. Confirm the spelling and value, remove cached legacy URLs, and check whether the project's player preset or browser policy governs the same behavior. Then add other parameters back one at a time.
Something missing or wrong here? Tell us and we will correct it. New to DynTube? Start with uploading and embedding.