Notification Bar

Last updated:

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.

Requirements

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.

Installation

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.

FAQ

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 let us know!

What if I have feedback on this app?

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

Or, if you see the feedback widget enabled, use that!

What if my question isn't answered above?

We love answering questions. Ask us anything via our community forum, or drop us a message.

Questions?

Was this page useful?

Next article

NPS Survey App

This is a basic site app which displays a simple 0-10 scale for users to tell you how likely they are to recommend your product. You can use this information to figure out your Net Promoter Score (NPS) Requirements The NPS survey app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later. Not running 1.30.0? Find out how to update your self-hosted PostHog deployment ! You also need to have enabled opt_in_site_apps: true in your posthog-js config…

Read next article