Every player setting, one by one
The Videas player is configured in two places, and the difference matters: some settings are written into the embed code, others are resolved by Videas on every playback. The first kind requires re-copying the code when you change it; the second applies on its own, even to a video that went online six months ago.
This article lists all of them, with each parameter’s exact name.
The two families of settings
Code parameters (the lists below) are written into the code you copy from Videas. On a <script> embed they travel as data- attributes; on an iframe, in the URL. Changing them afterwards does nothing to the code already pasted on your site: you have to fetch it again.
Player settings — light/dark theme, accent color, logo, logo position, eco mode by default — are not in the code. Videas resolves them at playback time, from your default preset. So you can change your brand color without touching a single page of your site. They live in Player settings, and are covered in Customize the player theme.
How to write a parameter
The parameter name is the same everywhere; only its form changes with the embed method.
In a <script> embed — lowercase, hyphens, prefixed with data-:
<script src="https://videas.com/embed.js" data-embed="YOUR-ID"
data-auto-play="1" data-muted="1" data-show-chapters="0"></script>In an iframe — lowercase with underscores, in the URL:
<iframe src="https://videas.com/embed/YOUR-ID/?auto_play=1&muted=1&show_chapters=0"
width="640" height="360" allowfullscreen allow="autoplay"></iframe>Yes/no values are written 1 or 0. A color is written without the hash: primary_color=884aff.
Two rules worth knowing:
- Videas only writes into the code what differs from your settings. If your preset already sets the dark theme, the copied code carries no
theme— so it follows your preset. That is deliberate: the code stays short and keeps reflecting your settings. - A parameter present in the code always wins. If you hard-code
theme=light, changing your preset will no longer affect that particular embed.
Playback and interactions
| Parameter (iframe) | Attribute (script) | Default | What it does |
|---|---|---|---|
auto_play |
data-auto-play |
0 |
Starts playback when the page loads |
auto_play_next |
data-auto-play-next |
1 |
Moves on to the next item in a collection |
loop |
data-loop |
0 |
Restarts from the beginning when the media ends |
muted |
data-muted |
0 |
Starts without sound |
shuffle |
data-shuffle |
0 |
Plays an audio collection in random order |
controls |
data-controls |
1 |
Shows the control bar |
pin_controls |
data-pin-controls |
0 |
Keeps the control bar always visible |
enable_download |
data-enable-download |
0 |
Allows downloading the file |
start_at |
data-start-at |
— | Starts at a given time, in seconds |
start_page |
data-start-page |
1 |
Opens a document at this page |
Autoplay requires muted. Every browser refuses to start an audible video without a user gesture: auto_play=1 alone will not start. Always write both, auto_play=1&muted=1. On an iframe, also add the allow="autoplay" attribute — Videas does it for you in the copied code.
Player chrome
| Parameter (iframe) | Attribute (script) | Default | What it does |
|---|---|---|---|
show_chapters |
data-show-chapters |
1 |
Shows chapter markers |
show_waveform |
data-show-waveform |
1 |
Shows the waveform of an audio file |
show_playlist |
data-show-playlist |
1 |
Shows the track list of a collection |
show_homepage_info |
data-show-homepage-info |
1 |
Title and duration on the poster screen |
show_homepage_play_button |
data-show-homepage-play-button |
1 |
Large play button on the poster screen |
show_eco_mode |
data-show-eco-mode |
1 |
Shows the eco mode button |
show_info_button |
data-show-info-button |
1 |
Shows the information button |
show_thumbnails |
data-show-thumbnails |
0 |
Page thumbnail column, on a document |
show_outline |
data-show-outline |
0 |
Outline of a document |
show_ads |
data-show-ads |
1 |
Plays the ads you configured |
show_logo |
data-show-logo |
1 |
Shows your logo as a watermark |
show_captions |
data-show-captions |
1 |
Captions under the images of a collection |
enable_pip |
data-enable-pip |
1 |
Allows picture-in-picture |
enable_fullscreen |
data-enable-fullscreen |
1 |
Allows fullscreen |
enable_zoom |
data-enable-zoom |
1 |
Allows zooming on an image |
enable_search |
data-enable-search |
1 |
Text search inside a document |
enable_slideshow |
data-enable-slideshow |
1 |
Automatic slideshow of an image collection |
slideshow_duration |
data-slideshow-duration |
5 |
How long each slideshow image stays, in seconds |
The logo watermark only appears once playback starts: it does not exist on the poster screen. That is expected, and it is not configurable.
Appearance
| Parameter (iframe) | Attribute (script) | Default | What it does |
|---|---|---|---|
theme |
data-theme |
depends on the media | dark, light, or colorful (audio only) |
primary_color |
data-primary-color |
your preset | Accent color, without the hash: 884aff |
icon_color |
data-icon-color |
your preset | Icon color of the audio player |
logo_position |
data-logo-position |
control bar | control_bar, top_left, top_right, bottom_left, bottom_right |
logo_opacity |
data-logo-opacity |
1 |
Watermark opacity, from 0 to 1 |
logo_click_url |
data-logo-click-url |
— | Address opened when the logo is clicked |
poster_fit |
data-poster-fit |
contain |
contain or cover, for the poster image |
collection_display_mode |
data-collection-display-mode |
drawer |
How a collection is laid out |
The default theme depends on the media: dark for a video, colorful for audio (it blurs the cover art behind the controls), light for everything else. The colorful theme only exists on the audio player; elsewhere it falls back to light or dark.
Those four — theme, color, logo, position — can also be set in Player settings, and that is almost always better: they then apply to all your embeds, including the ones already online.
Size and display
Size is not set by a parameter but by the code attributes, which Videas writes for you: data-width, data-height and data-aspect-ratio on a <script> embed; width, height and a style on an iframe. Leave responsive mode on and the player follows the width of your page while keeping its proportions.
Button display (the player opens over the page on click) is set with data-embed-mode="popover", data-trigger and data-trigger-label. It only exists in <script> form: an iframe has no equivalent. All of it is chosen in the embed window, without writing a line.
What the player URL does not do
The address of the player page — the one See it in a new tab opens — is there to check your settings, not to embed. Pasted as-is into WordPress, Wix, Squarespace or Webflow, it produces a clickable link, not a player: those platforms only auto-embed the services they know. To embed, copy the code. Only pages that can embed any address — Notion, for instance — accept the bare URL; Videas then hands it to you directly, once you pick Notion as the destination.
What each setting is for: the Player product page describes the features these parameters drive, where this page only gives their exact syntax.
Which settings apply without copying the code again?
The ones that are not in the code: light/dark theme, accent colour, logo, logo position, default eco mode. Videas resolves them at playback time, from your default preset — so you can change your brand colour without touching a single page of your site.
Every other parameter, the ones listed in the tables in this article, is written into the code you copied: changing them has no effect until you fetch the updated code and replace the one on your page.
Why doesn’t the copied code contain every parameter?
Because Videas only writes what differs from your settings. If your preset already sets the dark theme, the code will not contain theme: the embed will follow your preset.
That is deliberate, and it has a useful consequence: the code stays short, and it keeps reflecting your settings as they evolve. Conversely, a parameter present in the code always wins — hard-coding theme=light freezes that embed, and changing your preset will no longer affect it.
How do I write a parameter in script and in iframe form?
The name is the same everywhere, only the form changes. In <script> it is written in lowercase with hyphens and the data- prefix: data-auto-play="1". In an iframe it is written in lowercase with underscores, in the URL: ?auto_play=1&muted=1.
Two conventions to know: yes/no values are written 1 or 0, and a colour is written without the hash — primary_color=884aff.
Can I paste the player URL instead of the code?
No, except in one case. The player page address is there to check a setting, not to embed: pasted into WordPress, Wix, Squarespace or Webflow it produces a clickable link, not a player. Those platforms only auto-embed services they know.
Only pages able to embed any address — Notion, typically — accept the bare URL. Videas then hands it to you directly, when you pick Notion as the destination in the embed window.
Does button display exist in iframe form?
No. Popover mode — the player that opens over the page on click — is set with data-embed-mode="popover", data-trigger and data-trigger-label, and only exists in <script> form. An iframe has no equivalent.
It is one of the few functional gaps between the two methods. If your platform filters JavaScript and forces you onto the iframe, inline display is your only option.
Related articles
- Embed a video on your website — the whole path, from code to paste
- Customize the player theme — colors, logo, and what applies without re-copying the code
- Customize the video player — presets, so you do not redo your choices on every media
- Secure an embed with a token — restrict who can display your player