Documentation

Create an account

Sign up at app.changelog.fast using one of three methods:

• Magic link — Enter your email and click the link sent to your inbox. No password needed.
• GitHub OAuth — Sign in with your GitHub account. This also enables the GitHub integration later.
• Google OAuth — Sign in with your Google account for quick access.

Create a project

Once signed in, click New Project from the dashboard. You'll need:

• Name — Your product or app name (e.g. "Acme App")
• Slug — A URL-friendly identifier (e.g. acme-app). This determines your public page URL.

You can also set a description, logo, and brand colour in project settings.

Write your first entry

Go to your project and click New Entry. Each entry has:

• Title — A short summary (e.g. "Dark mode support")
• Content — Written in Markdown using the built-in editor. Supports headings, lists, code blocks, links, and images.
• Category — Choose from feature, improvement, fix, or other. Shown as a coloured badge on the public page.

Entries are saved as drafts by default. You can edit and preview before publishing.

Publishing

When your entry is ready, click Publish. This will:

1. Make the entry visible on your public changelog page
2. Show it in the embeddable widget (with an unread dot for returning visitors)
3. Send email notifications to all active subscribers (if you have any)

Installation

Add this script tag to your site, just before the closing </body> tag:

<script
  src="https://widget.changelog.fast/widget.js"
  data-project="your-project-slug"
  data-position="bottom-right"
  data-color="#0EA5E9"
></script>

Replace your-project-slug with your project's slug from the dashboard.

Options

Styling & behaviour

• Uses Shadow DOM for complete style isolation — won't affect your site's CSS.
• A red unread dot appears when new entries have been published since the user last opened the widget. Tracked via localStorage.
• The panel includes a "View all" link to your full public changelog page.
• On paid plans, the "Powered by changelog.fast" footer is removed.

Hosted URL

Your public page is available at:

https://changelog.fast/your-project-slug

It includes your project name, logo, brand colour, entry list with category badges, rendered Markdown content, and a subscribe form.

Custom domain Pro

On paid plans, you can use your own domain (e.g. changelog.yourapp.com).

1. Go to Settings > Custom Domain
2. Enter your domain
3. Add a CNAME record pointing to proxy.changelog.fast in your DNS provider (set to DNS only / grey cloud if using Cloudflare)
4. SSL is provisioned automatically via Let's Encrypt on the first visit

Subscribe form

The public page includes an email subscribe form at the top. Visitors enter their email to receive notifications when you publish new entries. No confirmation email is required — they're subscribed immediately.

Email notifications

When you publish a changelog entry, an email is sent to all active subscribers. The email includes:

• Entry title and category badge
• A preview of the content (first ~200 characters)
• A "Read more" link to the full entry on your public page
• An unsubscribe link at the bottom

Emails are sent via our delivery partner and are branded with your project name.

Managing subscribers

View and manage your subscriber list from Subscribers in the dashboard sidebar.

• View — See all subscribers with their email, status (active/unsubscribed), and subscribe date
• Export — Download your subscriber list as a CSV file
• Remove — Manually remove individual subscribers

Subscriber limits depend on your plan:

Plans

Annual billing saves 20% — that's £9.58/mo billed as £115/year.

Managing your subscription

Go to Billing in the dashboard to:

• Upgrade — Choose a plan and complete checkout via Stripe
• Manage — Open the Stripe billing portal to update your payment method, view invoices, or switch between monthly and annual billing
• Cancel — Cancel from the billing portal. Your plan stays active until the end of the current billing period. No partial refunds.

All prices are in GBP. Payments are securely processed by Stripe.