Get started with Digital Samba Embedded: rooms and sessions
Digital Samba Embedded lets you run full-featured, GDPR-compliant video conferencing inside your own product or website. Everything starts in the dashboard: you sign up, test a session in your demo room, and create rooms configured for your exact use case. This guide walks you through each of those first steps.
Table of Contents
- Sign up
- Rooms and sessions: the two concepts to understand first
- Start a session in your demo room
- Testing out room features
- Create and configure a new room
- Let's have a look at an example
- Frequently asked questions
This guide shows you how to get started with Digital Samba Embedded using the dashboard alone – no code required. Once your rooms are set up, you can go further with the REST API and SDK, which we cover in separate guides.
Sign up
To get started with Digital Samba Embedded, follow these steps:
1. Visit the Digital Samba sign-up page at https://dashboard.digitalsamba.com/signup and fill in the required information: your work email address and a password. Your team is created the moment you complete the sign-up.
2. During sign-up, you will be asked to choose your subdomain. The subdomain is the unique identifier for your team – think of it as your team name. Pick something memorable that represents your organisation, because it appears in every room link you share, such as https://yourcompany.digitalsamba.com/room.
Once you have completed the sign-up process, you will land on your dashboard. It opens on the Statistics section, where you can track participation minutes, concurrent sessions and recording usage for your billing period. The left-hand menu gives you access to your team, roles, rooms, sessions, webhooks and the developer documentation.
One thing worth knowing from day one: accounts that stay inactive for over six months are automatically deleted. Team owners receive several email warnings beforehand, and starting a single session is enough to keep the account active.
Rooms and sessions: the two concepts to understand first
Digital Samba Embedded is built around two concepts, and the distinction matters for everything you do later:
- A room is a permanent collection of settings and roles, configured for a concrete video conferencing purpose. A room keeps existing until you delete it, and you can reuse it as often as you like.
- A session is what happens when people actually meet in a room: it starts when the first participant joins and ends when the last one leaves or someone expressly ends it. A single room can host any number of sessions over time.
In practice, you might create one room for weekly team meetings, another for customer demos and a third for webinars – each with its own branding, roles and feature set – and every meeting held in them is recorded in the dashboard as a separate session.
Start a session in your demo room
To get a feel for the video conferencing experience and test the HD quality and UI of Digital Samba, follow the steps below:
- Access your Digital Samba Embedded dashboard by logging into your Digital Samba account.
- Click the 'Start Session' button to initiate a session in the demo room that comes ready to use with your new account.
To add participants to your video conference, copy the session link and share it with anyone, whether or not they belong to your team or organisation. Participants join straight from the browser – there is nothing for them to download or install.
Before joining a session, Digital Samba Embedded prompts you to test your camera, speakers, microphone and virtual background settings, so you can confirm everything works before you appear on screen.
A quick note on virtual backgrounds: they are supported on desktop browsers, including Chrome, Edge, Firefox and Safari (background blur is the one option not available in Safari). A new virtual background engine, currently in beta, extends support to iOS devices; Android support is on the product roadmap but not yet available.
The demo room is a preset room designed for your team's use. Digital Samba offers far more flexibility for configuring rooms to your specific requirements – we will explore room configuration in the following sections.
Testing out room features
1. Test your devices before joining
Before any video conference, it pays to confirm that your camera, speakers and microphone work. A thirty-second check prevents the classic 'can you hear me?' start, keeps communication clear and lets you fix problems while nobody is waiting.
The join screen handles this for you. When you open a room link, you can:
- Select your preferred camera, speaker and microphone – choose between built-in and connected devices.
- Run the audio and video tests to confirm everything works before you join.
Once you are inside a session, you can start exploring the room's features. Here are the key ones to try first:
2. In-session features to try
2.1. Hosting participants at scale
Digital Samba Embedded supports two room configurations: interactive meetings with up to 100 participants where everyone can broadcast simultaneously, and large events or webinars with up to 500 participants and up to 15 concurrent broadcasters. Each room has its own 'Maximum participants' and 'Maximum number of broadcasters' settings, within the limits of your plan – you can check the current limits on the Digital Samba Embedded pricing page.
2.2. Mute and unmute participants
As a moderator, you can directly mute participants' microphones and turn off their cameras to keep sessions focused. Turning them back on works the other way around: you send a request, and the participant accepts or declines it – their microphone and camera stay under their own control, which matters for privacy.
2.3. Screen share
Share your screen to present documents, slideshows or any other content to the participants. Screen sharing is available on every plan, including the free tier; note that mobile users can watch a shared screen but cannot share their own.
2.4. Chat
Use the in-room chat to share links, ask questions or add context during the session. Even if your team lives in a tool like Slack, an in-room chat keeps the conversation where the meeting is happening, so nobody has to switch windows.
2.5. Hand raise and reactions
Test the hand raise feature to signal that you want to speak or ask a question – it keeps discussions orderly and helps the moderator manage engagement. You can also enable emoji reactions, so participants can respond without interrupting the speaker.
2.6. Recordings and more
On paid plans, you can record sessions for future reference or sharing – recordings can run up to eight hours each. Rooms can also include a whiteboard, shared notes, polls and quizzes, Q&A, breakout rooms, live captions and transcription, depending on which components you enable.
3. Experience different modes – auto mode & tiled mode
Digital Samba offers two layout modes, and it is worth trying both:
- In auto mode, the system adjusts the layout automatically, magnifying the active speaker, open content or shared screen – a hands-off experience suited to less experienced participants.
- In tiled mode, you control the layout yourself: pin the participants you want to keep watching, expand any tile to full screen or drag handles to rearrange tiles.
- The 'minimise own tile' option lets you shrink your own video to free screen space for everyone else's tiles or shared content.
4. Participants' panel
Familiarise yourself with the participants' panel, which lets you manage participants remotely:
4.1. Camera and microphone control
You can turn off other participants' cameras to prevent distractions, and silently request that they unmute their microphones or turn their cameras back on – each participant decides whether to accept.
4.2. Remove participants
In certain situations, you may need to remove a participant from the video conference. Use this function carefully and judiciously.
5. Settings panel
From the settings panel, you can personalise your own session experience: set your preferred language for the user interface, configure virtual background settings and select the camera, microphone and speaker you want to use.
Create and configure a new room
To create a new room in Digital Samba Embedded:
- Go back to the Digital Samba dashboard.
- In the Rooms section, click the 'Create a room' button.
You can also clone an existing room from the three-dot menu next to it, or click 'Meet now' in the dashboard header to create a room on the fly and join it instantly. Beyond the dashboard, rooms can be created through the REST API and through the Google Calendar and WordPress integrations.
Before you start tweaking settings, one rule is worth understanding: every room setting except 'Privacy' and 'Maximum participants' is inherited from your team's default room settings. If you override a setting in a room, it keeps your value; everything you leave untouched follows future changes to the defaults. Setting up sensible defaults first saves a lot of repeated work – we explain how in our guide to configuring your default room settings in the dashboard.
Room settings are organised into sections, and each option comes with a short description of what it does right next to it. The main sections are:
General settings
In the general settings, you can:
- Give your room a descriptive name and an optional description,
- Set the privacy level: in public rooms, anyone with the room link can join; private rooms require a session token in the link,
- Define the maximum number of participants and of simultaneous broadcasters,
- Specify the default language for the room interface, choosing from 16 supported languages,
- Add roles to the room and pick the default role for participants who join without one, and
- Strengthen privacy by enabling end-to-end encryption, which protects usernames, chat messages, whiteboards and audio/video streams with keys that only the participants hold. Keep in mind that captions are not available in end-to-end encrypted sessions.
Branding settings
Make the room look like your product by:
- Choosing the primary colour for buttons and interactive elements,
- Selecting a background colour and a toolbar colour,
- Deciding between a light or dark appearance for the session's panels, modals and join screen,
- Positioning the toolbar on the left, bottom or right of the room, and
- Uploading a custom logo to display in rooms and recordings (available on the Create plan and higher).
Components settings
Switch individual features on or off for the room: screen sharing, the participants' panel, chat, raise hand, emoji reactions, virtual backgrounds, the whiteboard, shared notes, picture-in-picture, pinning, full screen, minimise own tile, the toolbar and top bar, and 'join' and 'leave' notifications, among others.
Recordings settings
Control how sessions are recorded. You can:
- Enable or disable recording for the room,
- Choose between auto and tiled layout for recordings,
- Decide whether recordings show your logo, participant name badges or captions,
- Show a recording consent reminder to whoever starts a recording, and
- Start recordings automatically when the first participant joins.
Join settings
Configure what happens when participants join:
- Show the join screen so participants can test their devices, or let them skip straight in,
- Display a consent message with a link to your privacy policy before anyone joins,
- Enable or disable participants' microphones and cameras on join,
- Lock the room so new participants must be admitted by someone with room-entry control,
- Choose the layout mode participants start in, and whether their own tile starts minimised, and
- Tune quality options such as HD video, noise suppression and echo cancellation.
These five are only part of the picture: depending on your plan and use case, rooms also have sections for the content library, chat, breakout rooms, polls & quizzes, Q&A, captions, transcription, restreaming, telephony and external streams. For a full walk-through of every section, see our guide to configuring your Digital Samba rooms using the dashboard.
Once you have completed the configuration, save your changes. Your newly created room will be listed in the 'Rooms' section, where you can join it directly or copy the room link to invite others. Note that copying a plain room link only works for rooms with a privacy level set to public – private rooms need tokenised links.
Let's have a look at an example
Let's say you want to create a room for sessions of around 40 participants. As the moderator, you want the room set up as follows:
- Set the default language to English,
- Add a Moderator role for yourself and set the default role for everyone else to Attendee,
- Set the primary colour of your room to blue and the background colour to green,
- Set the appearance to the dark theme,
- Position the toolbar on the right,
- Enable screen share, chat, access to the participants' panel, pinning and recording, and
- Disable microphones and cameras when users join the conference.
With those settings saved, the room opens in your brand's colours with the dark theme and the toolbar on the right, everyone joins muted and with cameras off, and participants can share their screen, chat, access the participants' panel and pin the people they want to view on a larger tile.
Digital Samba Embedded ships with five preset roles – Moderator, Speaker, Attendee, Teacher and Student – and you can design your own roles with granular permissions. Our guide to custom roles in the Digital Samba dashboard covers this in detail.
Once you are satisfied with your room settings, copy the invite link and send it to your participants. As mentioned before, this option is available for rooms with a privacy level set to public; private rooms require tokenised links instead.
Congratulations! You have created and configured a room in the Digital Samba Embedded dashboard. From here, you can automate the same work with the developer API – our guide to configuring your team settings with the Digital Samba developer API is a good next step – and get notified about session events in your own app using webhooks.
Frequently asked questions
What is the difference between a room and a session in Digital Samba Embedded?
A room is a permanent collection of settings and roles configured for a specific video conferencing purpose, and it exists until you delete it. A session is a single live meeting held in that room: it starts when the first participant joins and ends when the last one leaves or someone ends it. One room can host unlimited sessions over time.
How many participants can join a Digital Samba Embedded session?
The platform supports two configurations: up to 100 participants with everyone able to broadcast simultaneously, or up to 500 participants with up to 15 concurrent broadcasters for larger events and webinars. The exact limit for your account depends on your plan, so check the Digital Samba Embedded pricing page for current details.
Do participants need a Digital Samba account to join a session?
No. For public rooms, participants join by opening the room link in their browser – no account, download or installation is needed. For private rooms, participants need a link that includes a session token, which you generate from your dashboard or through the API.
Can I create rooms without using the dashboard?
Yes. Rooms can be created programmatically through the Digital Samba REST API, as well as through the Google Calendar and WordPress integrations. The dashboard's rooms list shows a Source column, so you can always see where each room was created.
Can I brand rooms with my own colours and logo?
Yes. Every room has branding settings for the primary colour, background colour, toolbar colour and position, and a light or dark appearance. Uploading a custom logo to show in rooms and recordings is available on the Create plan and higher.
What happens to my account if I stop using it?
Accounts that remain inactive for more than six months are deleted automatically. Team owners receive multiple email warnings first, and starting one session is enough to keep the account active.
Share this
You May Also Like
These Related Stories

Switching from Twilio to Digital Samba: A Seamless Migration Guide

Twilio Video vs Digital Samba: Why Developers Are Choosing a Low-Code Video API

