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>
-
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.<script src="https://api.lytmark.com/widget.js" data-id="YOUR_PROJECT_ID"></script> -
Open your layout
Open the HTML of your site or app, or the shared layout or footer template every page uses.
-
Paste before </body>
Paste the snippet right before the closing
</body>tag.<!-- your layout or footer template --> … <script src="https://api.lytmark.com/widget.js" data-id="YOUR_PROJECT_ID"></script> </body> </html> -
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:
<!-- 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.
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.