Skip to main content

Speaker widget

C
Written by Customer Success

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.

Widgets Speakers page with settings and preview.

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.

Embed speakers widget window with the options form on the left and the code with Copy and Preview on the right

Classic speaker widget with Aino Aalto in Featured Speakers and speaker cards under All speakers

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: hideFeaturedSpeakersFromAllSpeakers

Show featured speakers

Label: Featured Speakers list

Heading of the featured section. Code: labels.featuredSpeakers

Featured Speakers

Label: All speakers list

Heading of the main list. Code: labels.allSpeakers

All speakers

Label: Learn more

Text of the link on each card. Code: labels.learnMore

Learn more

Pagination: Speakers shown per page

Cards per page in All speakers. Code: paginationPageSize

12

Speaker social media links

Icon links on a speaker's card and profile. Code: socialMediaLinks

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.

Earlier speaker social media link editor with the Speaker field and six URL fields

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.

Speaker Profile showing Aino Aalto’s introduction and two assigned sessions

Example: change a label and accent color

  1. In the legacy text/props block, set labels.allSpeakers to Meet the speakers.

  2. Save the updated code on a test page and check the heading.

  3. 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.

Related articles

Did this answer your question?