Skip to main content

⚙️ Settings

The Settings page lets you override your BigBlueButton server defaults from one place. It opens with a BigBlueButton Server Settings header, a Settings jump to side menu, and a pinned Reset to default / Save bar at the bottom.

note

Editing settings requires the edit-settings privilege — root and admin accounts always have it.

Full Settings Page


🧭 The nine sections​

Use the Settings jump to menu to move between the nine sections:

#SectionWhat you control
1🤖 Artificial IntelligenceAI transcription & meeting summaries, subtitle language
2📱 Mobile ApplicationEnable the mobile app + store links
3🌐 Custom Domain NameServe meetings from your own domain
4🎛️ Meeting General SettingsEvery default applied to new meetings
5🎞️ Recording formatsWhich playback formats are produced
6👥 BBB Userdata Custom SettingsPer-user client defaults & whiteboard tools
7🔒 Lock settingsWhat viewers can do once a meeting starts
8🚫 Disable featuresTurn client capabilities off
9{ } Custom Client SettingsAdvanced settings.yml overrides

🤖 Artificial Intelligence​

  • Enable meetings recording transcriptions and summarization — turn on AI transcripts and summaries for your recordings. See AI Summary.
  • Subtitle Language — choose the language your presentation is translated into in the player.

📱 Mobile Application​

  • Enable BiggerBlueButton mobile application — let mobile users share their screen through the app.
  • Quick links to Explore the app, Google Play, and the App Store. See Bluetune AI.
note

Changing the mobile-application toggle requires an active subscription.


🌐 Custom Domain Name​

  • Enable custom domain name — serve your meetings from your own domain.
  • Fully Qualified Domain Name field and a Favicon (.ico) upload.
tip

Create a CNAME record from your DNS to ns1.biggerbluebutton.com — the domain is validated live before it's enabled.


🎛️ Meeting General Settings​

Defaults applied to every meeting (leave a field blank to use the default):

FieldWhat it sets
HTML5 Client TitleName shown in the meeting client
Welcome MessageGreeting shown when people join
LogoutURLWhere participants go after leaving
Max ParticipantsCap on users per meeting
Default Meeting DurationAuto-end after N minutes
Meeting LayoutDefault layout (e.g. Smart layout)
Banner Text / Banner ColorIn-meeting banner
Server RegionPreferred media region
Default LanguageClient UI language
Guest PolicyAlways accept · ask moderator · always deny
Default Presentation · Logo · Virtual BackgroundUploads applied to meetings

This section also holds two groups:

  • ⏳ End when no moderator — a toggle plus moderator-presence delays, camera caps (per user / per meeting), meeting expiry timers, and max pages.
  • 🎥 Recording & meeting defaults — checkboxes for the default recording behaviour and in-meeting permissions (record enabled by default, auto-start recording, allow start/stop recording, webcams only for moderators, mute all on start, breakout-room options, AI summary & transcription, and more), plus Unpublish recordings after (days).

🎞️ Recording formats​

Choose which playback formats each recording produces — Presentation, Video, and Podcast. At least one format must stay enabled.


👥 BBB Userdata Custom Settings​

Per-user client defaults pushed to every meeting:

  • Audio / video / layout preferences — listen-only mode, enable video, record webcam, show participants and public chat on login, prefer dark theme, hide bars/notifications, and many more.
  • Preferred Camera Profile — default webcam quality (default hd).
  • BBB HTML5 Theme and a custom style URL.
  • Presenter Tools and Multi User Tools — pick which whiteboard tools (select, draw, shapes, text, laser…) are available.

🔒 Lock settings​

Restrict what viewers can do once a meeting starts — disable webcams, microphones, private chat, public chat, or shared notes; hide the user list; apply lock settings on join; let moderators toggle lock-on-join; and hide viewers' cursors or annotations.


🚫 Disable features​

Turn off client capabilities you don't want available — for example breakout rooms, captions, chat, presentation downloads, external videos, layouts, learning dashboard, polls, screenshare, shared notes, virtual backgrounds, live transcription, timer, and more.


{ } Custom Client Settings​

Advanced overrides written to settings.yml, grouped under Public and Private, with a live Formatted JSON Preview so you can review your changes before saving.


tip

When you're done, use the pinned Save bar at the bottom of the page — or Reset to default to roll everything back.