Notification Bar

Last updated:

What does the Notification Bar do?

The Notification Bar app is a site app which enables you to display a customised banner on your site to notify users about events such as product releases, sales, and events.

Site apps are a new, big, and currently beta feature which enable you to inject code from PostHog into your website via posthog-js.

What are the requirements for this app?

The Notification Bar requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.41.0 or later.

Not running 1.41.0? Find out how to update your self-hosted PostHog deployment!

You'll also need to manually opt in to the site apps feature, as it's currently in beta.

How do I install the Notification Bar?

First, you need to manually opt in to the site apps beta. You can do this by configuring your posthog-js initialization to include opt_in_site_apps: true. Please be aware you do this at your own risk.

Once you've opted in, simply visit the 'Apps' page in your PostHog instance, search for 'Notification Bar' and press install. You can then use the blue gear icon to configure the app.

Configuration

OptionDescription
Domains
Type: string
Required: False
Comma separated list of domains to activate on. Leave blank to enable all. For example: "localhost,app.posthog.com"
HTML to show in the notification bar
Type: string
Required: True
Position of the notification bar
Type: choice
Required: True
Background color
Type: string
Required: True
Text color
Type: string
Required: True
Link color
Type: string
Required: True
CSS override
Type: string
Required: False
Remember close
Type: choice
Required: False
Remember if the user has closed the notification bar, and don't shor it again. This resets if you update the notification bar's text.

Is the source code for this app available?

PostHog is open-source and so are all apps on the platform. The source code for the Notification Bar is available on GitHub.

Who created this app?

We'd like to thank PostHog team member Marius Andra for creating this app. Thanks, Marius!

Who maintains this app?

This app is maintained by PostHog. If you have issues with the app not functioning as intended, please raise a bug report to let us know!

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our Support page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.

Questions?

Was this page useful?