Skip to main content

Embed the sponsor widget on your website

C
Written by Customer Success

Maintain an existing legacy sponsors 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 sponsors 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 sponsors feature must be on. If it is off, the widget shows "Please turn on the “Sponsors” 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 > Sponsors, or select Add sponsors to your website in Sponsors. This opens the V2 builder. See Switch to website widgets V2 before replacing a legacy embed.

Widgets Sponsors 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.

Widget tab with the options on the left and the code with Copy and Preview on the right

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": "sponsors",
"showAllSponsors": true
}
</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 a copy of the code you use; legacy options are stored in that 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

Categories to show

All categories, or Specific categories and then the categories in Select categories. Code: showSelectedCategories

All categories

Sponsors displayed per category

Show limited number shows 9 sponsors in Large categories, 12 in Medium and 15 in Small, then Show all. Show all sponsors removes the category's initial display limit. Code: showAllSponsors

Show limited number

Cover images on the sponsor list view

Show cover image adds the cover image to the cards of sponsors in Large categories. Code: showCoverImageInListView

Hide cover image

Sidebar integrations

Show adds the booth's Side bar integrations (slido, etc) links to the sponsor window as embedded pages. Code: showSidebar

Hide

Deck carousel

Show adds the booth's Sponsor deck (carousel) slides to the sponsor window, under the social media links. Code: showCarousel

Hide

Share button

Show adds a Share button to the sponsor window. It copies a link to your page that opens this sponsor. Code: showShareButton

Hide

Widget preview with category headings, counts, sponsor cards with Learn More and a Show all button

What visitors see

  • One section per category that has sponsors, in your category order, with the number of sponsors next to the category name.

  • Sponsors in each category follow Sponsor display order in Sponsors > Settings.

  • Each card shows the logo, name, subtitle on one line and Learn More.

  • A Filters button when sponsor custom fields have Make filterable on and have values. Visitors choose values, then Apply or Clear filters.

Selecting a card opens the sponsor window with:

  • The cover image, for sponsors in Large categories.

  • The logo, name and subtitle.

  • Share (if on), Website, Facebook, LinkedIn, Twitter and Instagram links that the sponsor has.

  • The carousel (if on).

  • The booth description.

  • The sessions the sponsor is linked to, under the name of the booth's Sessions tab, or "Related events". Times are in the event's time zone. The list includes sessions limited to specific lists.

  • Side bar integrations (slido, etc) links (if on): as a side panel on wide screens, and as tabs next to Information on narrow screens.

A link copied with Share adds ?showCompany= and the sponsor ID to your page address. Opening it scrolls to the widget and opens that sponsor.

Widget preview with a sponsor window open showing the logo, links, description and sessions

Change logo sizes

Add sponsorLogoSize to the code, inside the text/props block. Sizes are in pixels for each category size.

"sponsorLogoSize": {
"large": 195,
"medium": 100,
"small": 75
}

Without it, logos are 135 px (Large), 100 px (Medium) and 75 px (Small).

Style the widget with CSS

Add rules to your website's stylesheet. These class names target parts of the widget:

Part

Class

Category heading

.brella-widget-sponsor-category-header

Number next to the category name

.brella-widget-sponsor-category-header-count

Sponsor name

.brella-widget-sponsor-category-sponsor-name

Sponsor subtitle

.brella-widget-sponsor-category-sponsor-subtitle

Learn More link

.brella-widget-sponsor-category-sponsor-learn-more-link

Show all button

.brella-widget-sponsor-category-show-all-button

Examples:

<style>
.brella-widget-sponsor-category-header-count { display: none !important; }
.brella-widget-sponsor-category-sponsor-subtitle { -webkit-line-clamp: initial !important; }
.brella-widget-sponsor-category-sponsor-name { color: #1d2939 !important; }
</style>

The first rule hides the count, the second shows full subtitles, the third changes the name color.

Change card widths, borders and the accent color by setting these variables on :root. The values shown are the defaults.

:root {
--brella-widget-min-large-sponsor-card-width: 320px;
--brella-widget-min-medium-sponsor-card-width: 220px;
--brella-widget-min-small-sponsor-card-width: 160px;
--brella-widget-sponsor-border: 1px solid #F0F0F0;
--brella-color-primary-600: #00af66;
}

--brella-color-primary-600 colors Learn More and Show all.

For websites that load pages with JavaScript, see Embed Brella widgets on a single-page website.

Limits

  • Visits to the widget are not counted in a sponsor's Traffic Analytics.

  • Legacy option choices are stored in the embed code. Update the code on your website when you change them.

Troubleshooting

Please turn on the “Sponsors” feature in your Admin Panel to use this widget
The sponsors feature is off. Open Sponsors and select Activate.

Join code is invalid.
The widget could not load the event or sponsors. Compare joinCode with Join code or URL slug in Details, then check whether the browser can reach Brella's API.

Related articles

Did this answer your question?