Skip to main content

Understanding Deep Links in the Brella App

Written by Purnima Jayasuriya

Deep links make it easier for attendees to get to the right place in Brella at the right moment. Instead of opening the app on the home screen, a deep link takes an attendee directly to specific event content, such as a session, attendee profile, chat, sponsor page, or other destination.

This guide explains what deep links are, how they work in the Brella app, and how to create and use them to give attendees quick access to the content they need.

Never build a deep link manually. Copy it directly from your browser.
Open your event in the Brella web app and navigate to the page you want attendees to reach. Copy the complete URL from your browser’s address bar. You can share this URL directly as a deep link or use it to create a QR code.

Before you start

1. Check the app version

Deep linking requires the Brella app version 14.0.0 or newer.

If an attendee has an older version installed, the link can still open the app, but instead of navigating to the intended screen, it will take them to the home screen or events list.

2. Use the correct domain

This is especially important for whitelabel apps.

The domain used in the deep link must match the app the attendee is using.
For example:

A whitelabel app will only open deep links generated from its own subdomain.

How to create and share a deep link

  1. Open the correct Brella web app. For the main Brella app, use the normal Brella domain. For a whitelabel app, use the customer's own subdomain.

  2. Navigate to the destination. Open the track, session, sponsor page, or other screen you want attendees to reach.

  3. Copy the URL from your browser. Use the complete URL shown in the address bar. For a QR code, paste this URL directly into your preferred QR code generator.

Where can deep links be used?

Deep links can be used across your event communications and content to help attendees quickly navigate to the relevant destination in Brella.

  1. Custom emails - Add a deep link to an email as a regular hyperlink or button. When an attendee selects the link, Brella opens and directs them to the linked destination.

  2. Announcements - Include deep links in announcements to direct attendees to content related to the announcement.

    For example, if you send an announcement reminding attendees that a session is about to start, you can include the session's deep link so attendees can access it directly.

  3. Stories - You can use deep links in Stories to direct attendees to relevant content in Brella.

The same principle applies wherever you use a deep link. Open the destination in the Brella web app and copy the URL directly from your browser rather than creating or modifying the URL manually.

Authentication: signed in vs signed out

What happens after an attendee opens a deep link depends on whether they are already signed in to Brella:

  • When the user is already signed in, the link takes them directly to the target screen.

  • When the user is signed out, the app first prompts them to sign in and then continues to the original destination. The user's intended context is preserved rather than lost.

Common deep link destinations

The examples below show common destinations you can link attendees to in Brella.

Important: These URLs are examples only. Do not build or edit deep links manually. Instead, open your event in the Brella web app, navigate to the destination you want to link to, and copy the URL directly from your browser's address bar.

Destination

Example link

Event home

https://next.brella.io/events/your-event

Session detail

https://next.brella.io/events/your-event/session/301977

Full schedule

https://next.brella.io/events/your-event/schedule

Attendee profile

https://next.brella.io/events/your-event/attendee/183247

Chat/meeting

https://next.brella.io/events/your-event/chat/125176

Sponsor page

https://next.brella.io/events/your-event/sponsor/88741

Speaker page

https://next.brella.io/events/your-event/speaker/10513

People directory

https://next.brella.io/events/your-event/people

Join an event

https://next.brella.io/join/your-event

Deep link to share attendee profile card

You can also use a deep link to direct attendees to share their profile card in Brella.



This is useful when you want to encourage attendees to access and share their event card directly from event communications.

  • Custom emails, such as a button encouraging attendees to share their event card.

  • Stories, allowing attendees to open the Share your card screen directly from a Story.

The Share profile card deep-link path is:

event/{event_slug}/account/share-profile

Example:

https://next.brella.io/events/foodeventdemo22/account/share-profile

The URL contains the event's unique event slug (foodeventdemo22 in the example above).

Refer to How to Share Your Profile Card to learn how attendees can share their own profile card using the Brella mobile app.

Troubleshooting

The app opens, but I land on the home screen instead of the linked screen.

Check the installed app version. This behavior occurs with versions older than 14.0.0. Update the app and try the same link again.

The whitelabel app ignores my link.
Check the domain. You most likely copied a next.brella.io URL. Open the event using the customer's own <customer>.brella.io subdomain, navigate to the destination again, and copy that URL.

I'm not sure whether my deep link is correct.
Open the URL in a normal web browser. If it takes you to the correct screen there, the deep link is valid.

Deep links do not bypass Brella's login or event access requirements. If an attendee is not signed in or has not yet joined the event, they must first complete the required login and/or event joining steps before they can access the linked content. Once access is completed, they can continue to the intended destination.

Did this answer your question?