Install the Lytmark changelog widget
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.
One line of code, live in about five minutes. Pick your platform for the exact steps.
Choose your platform
HTML
Paste one line before </body> in the layout every page shares.
~5 minOpen guide →React
One line in index.html, or a small component with useEffect.
~5 minOpen guide →Next.js
next/script in app/layout.tsx or pages/_app.tsx.
~5 minOpen guide →Vue
One line in index.html, or onMounted in App.vue.
~5 minOpen guide →WordPress
The free WPCode plugin, or your child theme’s functions.php.
~5 minOpen guide →Webflow
Site settings › Custom code › Footer code. Paid Site plan.
~5 minOpen guide →Framer
Site settings › Custom code, at the end of the body tag.
~5 minOpen guide →Shopify
Themes › Edit code › theme.liquid, one line above </body>.
~5 minOpen guide →Mobile apps (WebView)
Flutter · React Native · Kotlin · Swift. The full widget in your iOS or Android app.
~15 minOpen guide →
Works the same everywhere
Every guide comes down to this one line, pasted right before </body> on every page. Your project ID is filled in for you on the Install page of your dashboard. Color, position, theme and launcher icon come from your project settings, so the snippet never changes when you restyle the widget.
<script src="https://api.lytmark.com/widget.js" data-id="YOUR_PROJECT_ID"></script>
Snippet options
Optional data-* attributes on the same <script> tag:
| Attribute | What it does | Example |
|---|---|---|
data-id | Your project ID. Required. | data-id="YOUR_PROJECT_ID" |
data-position | Set to none for no round button: the widget opens only from your own elements. The corner itself is set in the dashboard. | data-position="none" |
data-launcher | Forces the round button on or off. Without it, the button hides on pages that have a data-lytmark-trigger element. | data-launcher="true" |
data-consent | pending: the widget works but stores no visitor ID and sends no analytics until you set it to granted. denied: never. | data-consent="pending" |
data-track | Set to false to turn off analytics and the visitor ID completely. | data-track="false" |
Open it from your own button
Any element with data-lytmark-trigger opens the widget: a button, a link or a menu item. With data-position="none" 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="N" on your element, and removes it at zero, so you can show your own badge:
/* The widget sets data-lytmark-unread="N" on your button while there are unread posts */
[data-lytmark-unread]::after {
content: attr(data-lytmark-unread);
}
Cookie consent
With a cookie banner, add data-consent="pending" to the snippet. The widget works right away, but stores no visitor ID and sends no analytics until the visitor accepts. Then set the attribute to granted, or to denied if they decline:
// When the visitor accepts cookies:
document.querySelector('script[data-id="YOUR_PROJECT_ID"]').dataset.consent = 'granted';
Identify signed-in users
If the widget runs inside your app, tell it who is signed in. Roadmap votes and ideas then go out under that user without asking for an email. The identity stays in the page’s memory only and is never used for analytics.
<!-- Before the snippet: who is signed in (rendered by your server) -->
<script>
window.lytmarkSettings = {
user: { email: 'ada@example.com', name: 'Ada Lovelace', id: 'user_123', hash: 'HASH_FROM_YOUR_SERVER' }
};
</script>
<script src="https://api.lytmark.com/widget.js" data-id="YOUR_PROJECT_ID"></script>
<script>
// Single-page apps, after sign-in or sign-out:
Lytmark.identify({ email: user.email, name: user.name, id: user.id, hash: user.lytmarkHash });
Lytmark.reset();
</script>
The hash is an HMAC-SHA256 of the trimmed, lowercased email (or of the id for users without one), made on your server with the secret from Settings › User identification. Never put the secret in frontend code.
// Node.js, on your server only
const crypto = require('crypto');
function lytmarkHash(email) {
return crypto
.createHmac('sha256', process.env.LYTMARK_IDENTITY_SECRET)
.update(email.trim().toLowerCase())
.digest('hex');
}
Turn on Require verified users in the same settings to accept votes and ideas only with a valid hash. More examples (React, Next.js, Python, PHP) are on the Install page of your dashboard.
Content Security Policy
The widget runs under a strict CSP without unsafe-inline. If your site sends a Content-Security-Policy header, allow these hosts:
script-srcandconnect-src:https://api.lytmark.com(the widget and its data)img-src:https://api.lytmark.comandhttps://media.lytmark.com(images in your posts)frame-src: YouTube, Vimeo and Loom, if your posts embed videos
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;
frame-src https://www.youtube.com https://player.vimeo.com https://www.loom.com;
Ready when you are.
Free plan, no card. Live in about five minutes.