Skip to main content

Embedding Your Changelog

Add a changelog widget or in-app notification bubble to your site

Overview

AutoChangelog provides two ways to embed your changelog directly in your website or application. The embed widget displays your full changelog inline, while the in-app bubble adds a floating notification button that opens a popover with recent updates.

Embed Widget

The embed widget displays your changelog entries directly within your page. It's perfect for a dedicated "What's New" or "Changelog" page on your website. The widget is self-contained and creates its own container element, so you just need to add the script tag where you want the changelog to appear.

Getting the Embed Code

Go to Settings → Embed Changelog in your AutoChangelog dashboard. Copy the script tag and paste it into your website wherever you want the changelog to appear. The widget will render right where you place the script.

HTML
<script src="https://autochangelog.com/embed/owner/repo.js"></script>

Replace owner/repo with your GitHub username and repository name, or just copy the exact code from your settings page which will have the correct values filled in.

Widget Customization

You can customize the widget's title, colors, fonts, and maximum height from the Embed settings page. The widget automatically handles dark mode based on your settings, supports password protection if enabled, and includes the email subscription form and RSS feed link.

In-App Bubble

The in-app bubble adds a floating button to your application. When users click it, a popover opens showing your recent changelog entries. This is great for SaaS applications where you want to make updates easily accessible without disrupting the user's workflow.

Getting the Bubble Code

Go to Settings → Embed Changelog and scroll down to the "In-App Widget" section. Copy the script tag and add it to your application, typically in your layout or header file so it appears on every page.

HTML
<script src="https://autochangelog.com/embed/owner/repo/in-app.js"></script>

Bubble Position

By default, the bubble appears in the bottom-right corner of the screen. You can change this to bottom-left from the embed settings page. The bubble has a slight offset from the screen edges and floats above your content.

Customization Options

Both the widget and bubble can be customized from your embed settings. You can change the title that appears at the top (defaults to "Release Updates"). You can set a custom highlight color that matches your brand. You can choose fonts for headlines and body text, either selecting from Google Fonts or using "inherit" to match your site's typography. You can set a maximum height for the widget to prevent it from taking over the page. And you can toggle the "Powered by AutoChangelog" branding (available on paid plans).

Password Protection

If your changelog is password-protected, the embed widget and bubble will show a login form instead of entries. Users enter the password once, and it's stored in their browser so they don't need to re-enter it on subsequent visits. The password is stored securely and validated against your settings.

Email Subscriptions

Both the widget and bubble include an email subscription form where visitors can sign up to receive notifications when you publish new entries.

Preview

Use the preview button in your embed settings to see exactly how your widget or bubble will look before adding it to your site. This lets you experiment with colors, fonts, and other settings without affecting your live site.

Still have questions?

Reach out to us at hello@autochangelog.com