Maintain an existing legacy speakers widget on your website. It loads content from Brella when the page opens, so content changes do not require new embed code.
For a new embed, use Show speakers on 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 Speakers feature must be active. If Content > Speakers shows Speakers feature is not active, select Activate. While the feature is off, the widget shows Please turn on the “Speakers” feature in your Admin Panel to use this widget.
You need access to edit the HTML of the web page where the widget goes.
Create a new embed
Open Widgets > Speakers, or select Add speakers to your website in Content > Speakers. 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. These images show the earlier builder and legacy widget.
Legacy code has this shape. joinCode is your event's join code (the URL slug for invite-only events). Keep the script address from your installed legacy code.
<!-- Inject Brella Widget Here -->
<div id="brella-widget" >
<script type="text/props">
{
"joinCode": "youreventjoincode",
"widgetType": "speakers",
"paginationPageSize": 12,
"labels": {
"featuredSpeakers": "Featured Speakers",
"allSpeakers": "All speakers",
"learnMore": "Learn more"
}
}
</script>
</div>
<script async src="..."></script>
<!-- Inject Brella Widget Here End -->
Empty fields and Show featured speakers are left out of the code. Hide featured speakers adds "hideFeaturedSpeakersFromAllSpeakers": true.
Legacy settings
These labels come from the earlier builder. Use the listed code keys to change an existing embed.
Setting | What it does | Default |
|---|---|---|
Show / hide featured speakers in main list | Hide featured speakers removes highlighted speakers from the All speakers section. They stay in the Featured Speakers section. Code: | Show featured speakers |
Label: Featured Speakers list | Heading of the featured section. Code: | Featured Speakers |
Label: All speakers list | Heading of the main list. Code: | All speakers |
Label: Learn more | Text of the link on each card. Code: | Learn more |
Pagination: Speakers shown per page | Cards per page in All speakers. Code: | 12 |
Speaker social media links | Icon links on a speaker's card and profile. Code: | none |
Speaker social media links
Social media links live only in the legacy widget code, not in the speaker profile. The earlier builder used Speaker social media links to create the socialMediaLinks settings. Keep those settings in your installed code.
For a new embed, use the social-link controls described in Show speakers on your website (V2).
The widget adds https:// to a link that has no protocol. Links open in a new tab.
What visitors see
A search box with the text Search by name, title, company, session.... It matches first name, last name, company, job title and the titles of linked sessions, with fuzzy and prefix matching.
Featured Speakers: speakers with Highlighted ticked, sorted by Highlight order. The section is hidden when no speaker is highlighted or no highlighted speaker matches the search.
All speakers: the main speaker list follows the order set by Display order in apps under Content > Speakers, with page controls.
Each card shows the photo, name, title, company, social media icons and the Learn more link. Selecting a card opens Speaker Profile with the bio under Introduction and the speaker's sessions sorted by start time. Each session shows date, time and duration in the event's time zone, location, title, subtitle and tags.
Example: change a label and accent color
In the legacy
text/propsblock, setlabels.allSpeakerstoMeet the speakers.Save the updated code on a test page and check the heading.
Ask your website editor to add this CSS to the page stylesheet:
:root {
--brella-color-primary-600: #2754c5 !important;
}
The All speakers heading reads Meet the speakers, and the widget accents use blue. Check the page on a narrow screen and open a speaker profile.
Give your website editor the copied widget code, the page address and your brand color. Keep advanced CSS changes in the website stylesheet.
Style the widget with CSS
The widget's own styles are injected by the script. Override them in your website's stylesheet.
Hide parts of the widget:
Search box:
.brella-widget-speaker-toolbar { display: none; }Page controls:
.brella-pagination { display: none; }Learn more link:
.brella-speaker-card-learnmore-link { display: none; }Featured section:
.brella-widget-highlighted-speakers { display: none; }All speakers section:
.brella-widget-all-speakers { display: none; }Section headings:
.brella-widget-grid-title { display: none; }
If you hide All speakers, hide the search box as well. Search results outside the featured section have nowhere to appear.
Change colors and sizes by setting these variables on :root:
:root {
--brella-color-primary-600: #00af66;
--brella-widget-speaker-gradient-rgb: 65, 62, 167;
--brella-widget-min-speaker-card-width: 320px;
--brella-widget-min-speaker-narrow-card-width: 180px;
--brella-widget-speaker-modal-width: 750px;
--brella-widget-border-radius: 8px;
--brella-widget-border-radius-small: 4px;
--brella-widget-background: #FFFFFF;
--brella-widget-secondary-background: #F9FAFB;
--brella-widget-text-color: #000000;
--brella-widget-text-muted-color: #667085;
--brella-widget-border: 1px solid #EAECF0;
--brella-widget-input-border: 1px solid #D0D5DD;
--brella-widget-speaker-card-background: #FFFFFF;
--brella-widget-speaker-tag-background: #EAECF0;
--brella-widget-modal-background: #FFFFFF;
--brella-widget-modal-header-background: #F9FAFB;
}
The values shown are the defaults. --brella-color-primary-600 colors the Learn more link and other accents. --brella-widget-speaker-gradient-rgb is the overlay on featured cards, as three RGB numbers.
Card photos are 150 px wide at most and cropped to fit. To change that, override .brella-speaker-card-image img, for example .brella-speaker-card-image img { max-width: none; width: 100%; }.
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>
The widget then renders again after each client-side navigation. Raise renderDelay (milliseconds) if your framework inserts the page content after the route change. You can also call window.brellaWidgetRender() yourself.
Limits
Social media links are stored in the widget code only. Paste the updated code each time you change them.
Legacy embed settings are stored in the code on your website. Keep a copy of that code.
Troubleshooting
Please turn on the “Speakers” feature in your Admin Panel to use this widget
The Speakers feature is off. Open Content > Speakers and select Activate.
Join code is invalid.
The widget could not load the event or speakers. Compare joinCode with Join code or URL slug in Details, then check whether the browser can reach Brella's API.
The widget looks different from the preview
Your website's styles apply to the widget. Inspect the element in the browser's developer tools and override the rule in your stylesheet. The widget's styles come from <style> elements the script injects, not from a separate CSS file.




