highreel
Developers

The banner

A strip in the Highreel's own look: the business's logo, "Ana, your 2026 Highreel is here" and a button. Pressing it opens their Highreel over your page.

3 min read

The tag

HTML
<script src="https://highreel.app/embed/v1.js" async></script>
<highreel-banner link="EACH_PERSONS_LINK"></highreel-banner>

The script goes once per page, anywhere; the tag goes where the banner should be. It fills the width of its container and sets its own height. EACH_PERSONS_LINK is the signed-in person's link, https://highreel.app/r/ followed by their 12-character token. The token on its own works too, in a token attribute instead of link.

Attributes

AttributeValuesWhat it does
linkThe person's linkWhose Highreel. Required (or token). A link to anything else hides the banner and logs one warning in the console.
variantcard (default), barcard: for a home or dashboard; from 560 pixels wide a phone peeks up beside the words with the top of the person's own cover, and narrower it stacks. bar: a slim strip 60 pixels tall for the top of any page.
openoverlay (default), taboverlay: the Highreel opens over your page. tab: it opens in a new tab.
dismissiblepresent or notAdds a × that hides the banner. This browser remembers, so it stays closed for that person on later visits.

Change link on an element that's already on the page and it shows the new person's banner, which suits a single-page app where the person changes without a reload. Remove it and it leaves nothing behind.

The two styles

The card, on a computer:

A real card, for Ana in an example habit app. Press it to open her Highreel.

The bar:

A real bar, for Ana in an example habit app. Press it to open her Highreel.
HTML
<highreel-banner link="EACH_PERSONS_LINK" variant="bar" dismissible></highreel-banner>

Each wears the colors and design of the Highreel it opens, with the business's own logo (or its initial) and name. The words are always the same: the person's first name and the year, then a button to open it (Open your Highreel on the card, Open on the bar). A bar too narrow for the full line says "Your 2026 Highreel is here" and never wraps.

Closing it

With dismissible, the × hides the banner and the script writes one key to your site's own localStorage, highreel:closed: followed by a short code made from the link (never the link itself), so it stays hidden for that person in that browser. Highreel isn't told. In a private window, or where storage is blocked, it simply shows again next time. Their Highreel stays at their link, so an email still opens it.

Events

The element dispatches events on itself, for your own analytics if you want them. They bubble, and none of them carries anything about the person.

EventWhen
highreel:readyThe banner has loaded and is showing.
highreel:missingThere's no such Highreel (not published, or a wrong link): the element hides.
highreel:openIt was pressed and the Highreel opened over the page.
highreel:closeThe Highreel over the page was closed.
highreel:dismissIts × was pressed.
JavaScript
document.querySelector('highreel-banner')
  .addEventListener('highreel:open', () => console.log('Opened their Highreel'))

If the banner hasn't loaded after 15 seconds, the element hides; a late answer still shows it.

Without the script

The banner is a page of its own, so a plain iframe works where scripts aren't allowed. Without the script it can't size itself or open the overlay: the whole banner is a link that opens the Highreel in a new tab. The bar suits this best, since its height never changes.

HTML
<iframe src="https://highreel.app/r/TOKEN/banner?style=bar"
  title="Your Highreel" style="width: 100%; height: 60px; border: 0; border-radius: 14px"></iframe>

TOKEN is the 12 characters after /r/ in the person's link. A banner for a Highreel that isn't there is an empty page, so hide the iframe yourself when your member has no link.

Questions

Can I change the banner's words or colors?

Not from your site: the banner wears the Highreel's own design and colors, set on its Design tab, so it looks like the story it opens. The business's name and logo come from the Highreel's Brand tab.

Does the banner count as an open?

No. Showing a banner records nothing. The open is counted when the person presses it and their Highreel plays, as "On your website" in the business's Analytics.

Will it follow my site's dark mode?

No. It keeps the Highreel's own colors on any page, light or dark, the way the Highreel itself does.

Keep reading

Your customers had a great year. Show them.

No account needed · from $99 per campaign