Maintain an existing legacy schedule widget on your website. It loads the schedule from Brella when the page opens, so content changes do not require new embed code.
For a new embed, use Add the schedule to your website (V2). Legacy embeds load from widget.brella.io.
Before you start
You need to be an organization admin or an event admin.
The schedule must be on. If Content > Schedule shows the start screen instead of tabs, turn the schedule on first.
You need access to edit the HTML of the web page where the widget goes.
The widget shows the schedule as visitors see it without signing in. See What visitors see before you publish it.
Create a new embed
Open Widgets > Schedule, or select Add the schedule to your website in Content > Schedule. This opens the V2 builder. See Switch to website widgets V2 before replacing a legacy embed.
Maintain a legacy embed
Keep a copy of the complete code already installed on your website. Change its settings in the text/props block, then test the page. The former Content > Schedule > Widget builder has been replaced by the V2 page.
These images show the earlier builder and legacy widget.
Legacy code has this shape. joinCode is your event's Join code (or URL slug for an invite-only event). Keep the script address from your installed legacy code.
<!-- Inject Brella Widget Here -->
<div id="brella-widget" >
<script type="text/props">
{
"joinCode": "youreventjoincode",
"widgetType": "schedule-tracks",
"layout": "timeline"
}
</script>
</div>
<script async src="..."></script>
<!-- Inject Brella Widget Here End -->
The earlier builder left empty values and false switches out of the code. Keep "widgetType": "schedule-tracks": without it the script shows an older schedule widget with a different layout.
If you change the event's Join code or URL slug in Details, update joinCode in the installed legacy code.
Legacy settings
These labels come from the earlier builder. Use the listed code keys to change an existing embed.
Setting | What it does | Default |
|---|---|---|
Layout | Timeline: tracks as rows, time from left to right. Linear: tracks as columns, time from top to bottom. List: one column of session cards grouped by start time. Code: | Timeline |
Accent color | Color of buttons, the selected date, filter badges and other accents. With the Default style, session tiles keep their track colors in the Timeline and Linear layouts; cards in the List layout take the accent color. Code: | Default (Brella green) |
Theme | Light theme or Dark theme for backgrounds and text. Code: | Light theme |
Style | Default: track colors, plus the accent color if set. Unicolor: every track in the accent color; needs an Accent color. B&W: black, white and gray only. Code: | Default |
Edges | Rounded or Sharp corners on tiles and buttons. Ignored in the List layout. Code: | Rounded |
Height | Full-height: the widget grows with its content. Fixed: the widget fills its container and scrolls inside it. The code gets | Full-height |
Pre-selected date | The event day shown when the page opens. Code: | the first day with sessions that is today or later; after the event, the first day |
Hide date buttons | Removes the day buttons at the top. Use it with Pre-selected date to show one day only. Code: | Off |
Pre-selected tracks | Shows only the chosen tracks when the page opens. Visitors can still change the filter unless the filters button is hidden. Code: | none |
Hide filters button | Removes the Filters button. Code: | Off |
Session cover images | Show adds the session's cover image to Session Details. Code: | Hide |
Options you add to the code by hand
These options were not in the earlier form. Add them inside the script type="text/props" block, each on its own line with a comma after the previous line.
Option | What it does |
|---|---|
| Shows times as |
| Switches to the List layout on screens 768 px wide or narrower, whatever Layout is set to. |
| Size of each track in the Timeline and Linear layouts, in pixels. Default 180 for Timeline, 400 for Linear. |
| List layout: shows each speaker's photo, name, job title and company on the card instead of names only. |
| List layout: adds an All day button that lists every day in one list, with a heading per day. The widget opens on All. |
Example:
{
"joinCode": "youreventjoincode",
"widgetType": "schedule-tracks",
"layout": "simplified",
"timeFormat": "24h",
"simplifiedLayoutOptions": { "showFullSpeakerInfo": true, "showAllTab": true }
}
What visitors see
The content sessions of every enabled track. Networking slots (1:1 meetings) are never shown. Tracks with no sessions on the selected day are hidden while Hide empty tracks is on in Content > Schedule > Settings.
Sessions restricted to specific lists are shown to every visitor. The widget has no sign-in, so list access can't be checked. Don't put confidential sessions in the schedule if the widget is public.
All times in the event's time zone, without a time zone label. Add a sentence next to the widget that names the time zone.
Day buttons at the top, one per day that has sessions: Day 1, Day 2 and so on, with the date on hover. If the days are not consecutive, the buttons show dates. When the buttons don't fit, a drop-down list replaces them. A one-day event shows the date instead, with Today, or Tomorrow, in front when it applies.
A Filters button that opens Filters with Track(s), Tag(s), Location, Session type (Regular, Virtual oriented), Speakers and any session custom field with Filterable on. Apply and Clear filters close the pop-up. A badge on the button counts the active filters.
Selecting a session opens Session Details: track, title, subtitle, Share, date and time, location, Part of: the parent session if any, tags, sponsor, description, session sponsors, Speakers, and the child sessions. More info on a track opens Track Details with the track's sponsor, description and Highlighted speakers.
Share copies the page URL with the session added, and shows Link copied to clipboard!. Opening that link scrolls to the widget and opens the session.
On screens 768 px wide or narrower, the track column of the Timeline layout is narrowed.
The List layout shows Load more (N remaining) when more sessions are available. Its cards are centered.
Open a day or a session from a link
?date=2027-12-01in the page URL opens the widget on that day.?showSession=<session ID>opens a session from the loaded day and scrolls to the widget. Includedateto target another day. The session ID is theidcolumn of a schedule export. Session links copied with Share use both parameters.
Style the widget with CSS
The widget's styles are injected by the script. Override them in your website's stylesheet.
Hide the Filters button:
.brella-schedule-filters-button { display: none; }Hide the day buttons:
.brella-schedule-tracks-day-buttons, .brella-schedule-date-selector { display: none; }Remove the outer spacing:
.brella-widget-root { margin: 0; padding: 0; }(default 16 px each, 0 and 8 px on screens 768 px wide or narrower)Change the accent when Accent color is Default:
:root { --brella-color-primary-600: #0099ff; }. AnaccentColororcolorThemesetting writes a color into the widget itself. Remove those settings before using this CSS override.Other variables with their defaults:
--brella-widget-background: #FFFFFF,--brella-widget-text-muted-color: #667085,--brella-widget-border-radius: 8px,--brella-widget-border-radius-small: 4px,--brella-widget-modal-width: 600px,--brella-widget-padding-base: 16px,--brella-widget-margin-base: 16px.
Most elements have a class that starts with brella-schedule-, for example brella-schedule-session-card, brella-schedule-session-title and brella-schedule-day. Inspect the element in your browser's developer tools to find the class.
Single-page websites
If your site renders pages with JavaScript and #brella-widget is not in the page when the script loads, add this line before the widget script:
<script>window.brellaWidgetOptions = { spaMode: true, renderDelay: 0 }</script>
Limits
You can put several Brella widgets on one page. Give each widget its own
divwith the IDbrella-widgetand its own settings block. A session deep link scrolls to the first matching container, so put the schedule widget first when you use those links.Legacy embed settings are stored in the code on your website. Keep a copy of that code.
The widget shows sessions only. Attendees bookmark, rate and join sessions in the app, not in the widget.
Visitors' browsers load the widget script and the schedule from Brella. Your website must not block requests to Brella.
Troubleshooting
Error: Couldn't fetch schedule data, please check the join code
The joinCode in the code does not match the event's Join code or URL slug in Details, or the request to Brella's API failed. Correct joinCode in the installed code, then see Troubleshoot the schedule widget.
The widget looks different from the preview
Your website's styles apply to the widget, or the code is missing "widgetType": "schedule-tracks". Compare the pasted code with your saved legacy code, then see Troubleshoot the schedule widget.
Hmm.. nothing found
No session matches the selected day and filters. Clear filters and reload resets the filters. Check that the tracks are enabled and the sessions are on content tracks.
An empty canvas is full.
The selected day has no sessions. Choose another day, or set Pre-selected date to a day with sessions.





