Skip to main content

⚙️ Settings (Admin)

This page describes the Settings area in BiggerBlueButton SaaS and what each parameter controls.
It’s meant as a quick guide, not a replacement for the official docs.

📸 Settings Overview​

Full Settings Page

🔑 Main Parameters​

Meeting / General​

  • welcome — Custom welcome message shown when users join.
  • maxParticipants — Maximum number of users allowed in a meeting.
  • logoutURL — Where participants are redirected after leaving.
  • record — Whether the meeting should be recorded.
  • duration — Default meeting duration (minutes).
  • bannerText — Optional text banner in the HTML5 client.
  • bannerColor — Color of the banner text.
  • guestPolicy — Guest handling (ALWAYS_ACCEPT, ALWAYS_DENY, ASK_MODERATOR).
  • meetingLayout — Default layout (e.g., SMART_LAYOUT).
  • region — Preferred server region.
  • logo — Logo displayed in the meeting UI.
  • favicon — Custom favicon for the client.
  • customDomainNameEnabled — Enable/disable custom domain feature.
  • customDomainName — Domain used when custom domain is enabled.

Recording​

  • recordingsUnpublishedByDefault — If true, recordings are unpublished until manually released.
  • unpublishRecordingsTimer — Days after which recordings are auto-unpublished.
  • recordingsSummarizationEnabled — Enable AI-based transcription/summary of recordings.
  • autoStartRecording — Start recording automatically when meeting begins.
  • allowStartStopRecording — Allow moderators to manually start/stop recording.
  • notifyRecordingIsOn — Show a notification when recording is active.
  • preUploadedPresentationOverrideDefault — If true, uploaded presentations replace defaults.

Breakout Rooms​

  • breakoutRoomsPrivateChatEnabled — Allow private chat inside breakout rooms.
  • breakoutRoomsRecord — Enable recording in breakout rooms.

Moderator Controls​

  • moderatorOnlyMessage — Message shown only to moderators.
  • allowModsToUnmuteUsers — Allow moderators to unmute participants.
  • allowModsToEjectCameras — Allow moderators to remove participant cameras.
  • allowPromoteGuestToModerator — Permit guests to be promoted to moderator.
  • allowRequestsWithoutSession — Allow external API requests without an active session.

Meeting Lifecycle​

  • endWhenNoModerator — End meeting if no moderator remains.
  • endWhenNoModeratorDelayInMinutes — Delay before ending when moderator leaves.
  • learningDashboardCleanupDelayInMinutes — Cleanup delay for learning dashboard.
  • meetingKeepEvents — Keep all meeting events for later replay.
  • meetingExpireIfNoUserJoinedInMinutes — Auto-expire if no one joins after N minutes.
  • meetingExpireWhenLastUserLeftInMinutes — Auto-expire after last user leaves.

Limits​

  • userCameraCap — Max cameras per participant.
  • meetingCameraCap — Max cameras for the meeting.
  • maxNumPages — Max number of whiteboard pages.

🧑‍💻 Join Parameters (bbb_*)​

  • bbb_ask_for_feedback_on_logout — Ask for feedback on logout.
  • bbb_auto_join_audio — Automatically join audio on entry.
  • bbb_client_title — Override the meeting client title.
  • bbb_force_listen_only — Force users to join listen-only mode.
  • bbb_listen_only_mode — Allow listen-only mode.
  • bbb_skip_check_audio — Skip audio test on join.
  • bbb_skip_check_audio_on_first_join — Skip audio test only on first join.
  • bbb_skip_echotest_if_previous_device — Skip echo test if device unchanged.
  • bbb_override_default_locale — Override default locale for UI.
  • bbb_direct_leave_button — Show leave button directly.
  • bbb_parent_room_moderator — Parent room moderator flag.
  • bbb_show_session_details_on_join — Show meeting details popup on join.
  • bbb_display_branding_area — Show/hide branding area in client.
  • bbb_auto_share_webcam — Auto-share webcam on join.
  • bbb_preferred_camera_profile — Preferred video profile (low/medium/high).
  • bbb_enable_video — Enable video for participants.
  • bbb_record_video — Record webcam streams.
  • bbb_skip_video_preview — Skip preview dialog before sharing video.
  • bbb_skip_video_preview_on_first_join — Skip preview only first time.
  • bbb_skip_video_preview_if_previous_device — Skip preview if device unchanged.
  • bbb_mirror_own_webcam — Mirror own webcam feed.
  • bbb_transparent_listen_only — Enable transparent listen-only mode.
  • bbb_force_restore_presentation_on_new_events — Force presentation restore on events.
  • bbb_multi_user_pen_only — Enable multi-user pen only mode.
  • bbb_presenter_tools — Tools available to presenters (shapes, text, etc.).
  • bbb_multi_user_tools — Tools available to multiple users.
  • bbb_custom_style — Apply a custom theme style.
  • bbb_custom_style_url — Apply a style from a hosted URL.
  • bbb_prefer_dark_theme — Prefer dark mode by default.
  • bbb_hide_presentation_on_join — Hide presentation on join.
  • bbb_show_participants_on_login — Show participant list on login.
  • bbb_show_public_chat_on_login — Show chat on login.
  • bbb_hide_nav_bar — Hide navigation bar.
  • bbb_hide_actions_bar — Hide actions bar.
  • bbb_hide_notifications — Hide notifications.
  • bbb_hide_controls — Hide UI controls.

🔒 Lock Settings​

  • lockSettingsDisableCam — Disable all participant cameras.
  • lockSettingsDisableMic — Disable all microphones.
  • lockSettingsDisablePrivateChat — Disable private chat.
  • lockSettingsDisablePublicChat — Disable public chat.
  • lockSettingsDisableNotes — Disable shared notes.
  • lockSettingsHideUserList — Hide participant list.
  • lockSettingsLockOnJoin — Apply lock settings on join.
  • lockSettingsLockOnJoinConfigurable — Allow moderators to configure lock on join.
  • lockSettingsHideViewersCursor — Hide viewers’ cursors.

📦 BiggerBlueButton Custom Parameters​

  • default_pdf — Default presentation file.
  • webcamBackgroundURL — Custom webcam background.

👉 For deeper detail on each parameter, see the official BigBlueButton API docs.