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.

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.

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

Snippet options

Optional data-* attributes on the same <script> tag:

AttributeWhat it doesExample
data-idYour project ID. Required.data-id="YOUR_PROJECT_ID"
data-positionSet 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-launcherForces the round button on or off. Without it, the button hides on pages that have a data-lytmark-trigger element.data-launcher="true"
data-consentpending: the widget works but stores no visitor ID and sends no analytics until you set it to granted. denied: never.data-consent="pending"
data-trackSet 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.

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="N" on your element, and removes it at zero, so you can show your own badge:

CSS
/* The widget sets data-lytmark-unread="N" on your button while there are unread posts */
[data-lytmark-unread]::after {
  content: attr(data-lytmark-unread);
}

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.

HTML
<!-- 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
// 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-src and connect-src: https://api.lytmark.com (the widget and its data)
  • img-src: https://api.lytmark.com and https://media.lytmark.com (images in your posts)
  • frame-src: YouTube, Vimeo and Loom, if your posts embed videos
Content-Security-Policy
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.