Add a changelog widget to any HTML site

Lytmark is an in-app changelog, public roadmap and feature-voting widget for SaaS products and web apps. Add a “What’s new” panel, an ideas box and roadmap voting to your product with one line of code, for a flat monthly price with no per-user limits.

This guide adds it to a plain HTML site or any server-rendered app (PHP, Rails, Django, static site generators): one line in the layout every page shares. You’ll get a “What’s new” panel with an unread badge and one-tap reactions on every update. On Pro, the same widget also gets Roadmap and Ideas tabs.

Before you start

  • A free Lytmark accountSign up at app.lytmark.com. No card needed.
  • Your project IDIt’s on the Install page of your dashboard, already filled into the snippet.
  • About 5 minutesOne line of code, pasted once for the whole site.

Install steps

PathYour layout or footer templateright before </body>

  1. Copy your snippet

    In your Lytmark dashboard, open Install and copy the snippet. Your project ID is already filled in there; in the examples on this page it’s YOUR_PROJECT_ID.

    Your snippet
    <script src="https://api.lytmark.com/widget.js" data-id="YOUR_PROJECT_ID"></script>
  2. Open your layout

    Open the HTML of your site or app, or the shared layout or footer template every page uses.

  3. Paste before </body>

    Paste the snippet right before the closing </body> tag.

    HTML
    <!-- your layout or footer template -->
        …
        <script src="https://api.lytmark.com/widget.js" data-id="YOUR_PROJECT_ID"></script>
      </body>
    </html>
  4. Deploy, then open it

    Deploy, then open your site or app once. This page turns green when we see it.

Use your own button

Prefer a link in your menu over the round button? Put data-lytmark-trigger on any element and add data-position="none" to the snippet, so there’s no floating button at all:

HTML
<!-- Trigger widget from your own button -->
<button data-lytmark-trigger>What's new</button>

<script src="https://api.lytmark.com/widget.js"
  data-id="YOUR_PROJECT_ID"
  data-position="none"></script>

While there are unread posts, the widget sets data-lytmark-unread on your element, so you can style your own dot.

Check that it works

Open the Install page in your Lytmark dashboard. The first time the widget loads on your site, its status turns green: Live on followed by your site’s host. On your site, the round button appears in the corner you picked in the dashboard (bottom right by default); click it to open the “What’s new” panel.

Using data-consent="pending" or data-track="false"? Then the check waits too: the widget reports your host only once tracking is allowed.

Not showing up?

You haven’t deployed yet

The widget loads wherever the snippet runs. Deploy, then open the deployed site. A local dev server works too: the Install page lists it as a local host.

Your browser shows an old version

Hard-refresh (Ctrl/⌘ + Shift + R) or open the site in a private window. If you use a CDN or cache plugin, purge it.

The code is only on one page

Put it in the shared layout, footer or site-wide settings so every page loads it. The status turns green as soon as any page with the code is opened.

An ad blocker or privacy extension hides it

Try a private window with extensions off. Most visitors don’t block it; this mostly affects your own browser.

Your site has a Content Security Policy

Allow https://api.lytmark.com in script-src and connect-src. Post images come from api.lytmark.com and media.lytmark.com.

CSP
script-src 'self' https://api.lytmark.com;
connect-src 'self' https://api.lytmark.com;
img-src 'self' https://api.lytmark.com https://media.lytmark.com;

Videos in posts also need frame-src; see the full list.

HTML changelog widget FAQ

Where exactly does the snippet go?

Right before the closing </body> tag, in the layout or footer template that every page shares. Then it loads on every page and you only add it once.

Does it work with static site generators?

Yes. With Hugo, Jekyll, Eleventy, Astro or any other generator, put the line in the base layout before </body> and rebuild.

Will it slow down my site?

The snippet adds a small loader, which loads the widget asynchronously. The widget is under 30 KB gzipped and draws inside Shadow DOM, so your styles and its styles never touch.

Can I change the color or position later?

Yes, in the Lytmark dashboard. Color and position come from your project settings, so the snippet stays the same and you never edit the code again.

Add Lytmark to HTML today.

Free plan, no card. Live in about five minutes.