MarktVerkennenUitproberen
Prijzen
InloggenBegin
PraktijkgidsToepassingen
Toepassingen

Changelog design: make your updates worth opening

A changelog people open is a run of short, dated cards on one ground, each with a link preview that says the same thing. Here is the page, the card and the sizes.

GradientlyGeverifieerd Gradiently-account·20 oktober 2026·7 min lezen
Cover: Choral Bell · GR·RRB2·58

Deze gids is nog niet beschikbaar in jouw taal, dus hier is hij in het Engels.

De korte versie

  • Changelog design is a public page of short entries, newest first, written for people who already use the product.
  • One visual ground should run across the page header and every entry card, so a release is recognisable before anyone reads the version number.
  • Each entry needs a version, a date written as YYYY-MM-DD in the page code, a one sentence title, and only the change groups that contain something.
  • The share image for a changelog entry is 1200×630 pixels, with the title large and in the centre, on the same ground as the page.
  • Design that card once. A spreadsheet of versions, dates and titles can fill the same layout for every later release.
Op deze pagina
What a changelog page is forThe anatomy of one entryOne ground across the header and every cardThe share image for each releaseWrite the change in customer languageA card for every release, from one sheet

Changelog design that gets opened uses one ground for the whole page: a header, then a short card for each release, newest first. Each card carries a version, a date and one sentence about what changed for the customer, and that same card is the 1200×630 image people see when the link is shared. Commit messages are for the team. This page is for the people who use the product.

What a changelog page is for

Put the newest release at the top, with its own address, so a post or an email can point at that version. The post is a separate job, one line of news, as in an announcement post. The changelog backs that line up with the date and the changes a customer would notice.

After launch this is the graphic a software company makes most often, and it does as much for SaaS branding as the first hero. If each entry looks like a different product, the brand looks unfinished even when the shipping is steady.

A what's new page in the app can stop at the title and link to the full entry. Same ground, same words. Email the same title and the same link.

The anatomy of one entry

One entry has a fixed reading order: version, date, title, then a few lines. The pictures here use Boardline, a fictional planning app, so you can judge the layout on its own.

VersionA number such as 2.4, or the ship date

On the card

Small label
Date2026-10-12 in code, 12 October 2026 for people

On the card

Beside the version
TitleThe change in a customer's words

On the card

Largest line, centred
GroupsAdded, Changed, Deprecated, Removed, Fixed, Security

On the card

Under the title. Skip empty groups.
LinkThis entry's address

On the card

Same corner every time
PartWhat it holdsOn the card
VersionA number such as 2.4, or the ship dateSmall label
Date2026-10-12 in code, 12 October 2026 for peopleBeside the version
TitleThe change in a customer's wordsLargest line, centred
GroupsAdded, Changed, Deprecated, Removed, Fixed, SecurityUnder the title. Skip empty groups.
LinkThis entry's addressSame corner every time
Five parts, in that order. If you need a sixth, the entry is trying to be a blog post.

Six groups, and skip the empty ones

Keep a Changelog files every line under Added, Changed, Deprecated, Removed, Fixed or Security. Show only headings with lines, and put Security or Removed first when someone may need to act. Hold unshipped lines under Unreleased until you name the version.

Changelog
What changed in Boardline
Newest release sits at the top.
Gradiently · @gradiently

The page header at blog banner size, 1200×600. The page name stays small. The promise of the page is the large line.

One ground across the header and every card

The header and every entry card should wear the same ground. Colour, grain and the corner for the product name stay fixed. Only the words change, so a release is still recognisable in a chat full of other brands.

In Gradiently that ground is a Mark: colour, light and grain behind the header and every card. It can move its calmest area behind the words and pick light or dark type per line. Keep the title off the bright middle of the green, where letters vanish. More on that is in text on a gradient.

Pine ink and deep pine for the header and for type, board green through the blend, mint and mist at the pale end, paper under the notes.
The header is the darkest, the entry card a step lighter, and the page behind the notes stays pale so the list is easy to scan.

The share image for each release

When someone pastes the link, the preview is often all they see. Use the same card at 1200×630, the Open Graph image size most platforms share. LinkedIn's link image is 1200×627, so one file covers both. Some chats crop toward a square: keep the title in the centre, with about 60 pixels of margin.

Link preview 1200×630

1200 × 630

Centre crop 630×630

630 × 630

Page header 1200×600

1200 × 600

LinkedIn post 1200×1200

1200 × 1200

X post 1600×900

1600 × 900

Design the link preview first. The centre square is what a cropped chat still shows. The page header is almost the same width.
Version 2.4
Comments stay with the card
12 October 2026
Gradiently · @gradiently

Version as a label, the change as the only large line.

Version 2.5
Share a board with one link
19 October 2026
Gradiently · @gradiently

Same size, ground and placement. Only the version, the date and the title change.

To build the image from the title, keep this layout and fill the words from the page. That is a dynamic OG image: one design, a new title each time. The tags belong in the HTML the server sends. The full set is in Open Graph tags.

html
<meta property="og:title" content="Boardline 2.4: comments stay with the card" />
<meta property="og:description" content="Comments stay on the card you left. A board can be shared with one link." />
<meta property="og:image" content="https://example.com/changelog/2-4.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:alt" content="Boardline 2.4 on a green ground: comments stay with the card" />
<meta property="og:url" content="https://example.com/changelog/2-4" />
<meta name="twitter:card" content="summary_large_image" />
<article id="v2-4">
  <header>
    <p>Version 2.4</p>
    <h2>Comments stay with the card</h2>
    <time datetime="2026-10-12">12 October 2026</time>
  </header>
  <ul>
    <li><strong>Added.</strong> A board can be shared with one link.</li>
    <li><strong>Fixed.</strong> Comments stay on the card you left.</li>
  </ul>
  <p><a href="/changelog">All releases</a></p>
</article>
Tags for one entry, plus the entry. The article id is the share address. og:image points at the 1200×630 card.

The image address has to be absolute

og:image needs a full https URL that loads with no login. A relative path, or a tag added by script after the page loads, is missed by most preview crawlers.

Write the change in customer language

The largest line on the card is the only line many people read. Write it the way a customer would say it to a colleague. Bug fixes and improvements spends that space on nothing.

Avoid

  • Bug fixes and improvements
  • Various updates
  • Version 2.4.0 shipped
  • We have been busy

Do

  • Comments stay with the card
  • Share a board with one link
  • CSV export leaves in March
  • Sign-in patched: update today
  • Three to seven words for what changed. The title is the result. The group line is the detail.
  • A readable date, such as 12 October 2026, and 2026-10-12 on the `time` element.
  • The version as a label. Major for a break, minor for an addition, patch for a fix. The number is not the headline.
  • Security or Removed first when that release has them. If something is deprecated, say when it goes.
  • Link a long guide instead of pasting it, so the entry stays short.

A card for every release, from one sheet

Do not redesign the card on release day. Design the 1200×630 card once, around the longest title you are willing to publish, then change only the version, the date and the title.

  1. 1

    Design the card once

    Set the size to 1200×630. Small label for version and date, title large and centred, product name in a fixed corner, margins of about 60 pixels.

  2. 2

    Write one row per release

    First row headings: version, date, title. Then one release per row. Use CSV, or TSV if a title contains a comma. Keep the file under 1 MB.

  3. 3

    Review every version

    Connect each heading to the matching text and read every row. A title on three lines needs fewer words.

  4. 4

    Create the pages, then export

    Each row becomes a page in that layout. Save a PNG at 1200×630 for og:image. One Undo removes a bad batch.

text
version,date,title
2.5,2026-10-19,Share a board with one link
2.4,2026-10-12,Comments stay with the card
2.3,2026-09-28,CSV export leaves in March
Newest first, like the page. Grouped notes stay on the changelog, not in this sheet.

Gradiently's bulk create does this from one page plus a CSV or TSV: headings in the first row, a file up to 1 MB, every row reviewed, then one page per release. The spreadsheet stays in the browser, and one Undo removes the batch. Bulk create is part of Pro. The routine is in bulk create from a spreadsheet.

Those rows can also feed the week's posts: LinkedIn at 1200×1200, X at 1600×900, laid out again with copy to sizes. For a run of posts, use the same idea as batch create social media content: fixed layouts, lines written first, then the sizes.

Ontwerp met een levend kleurverloop

Posts, stories, dia’s en banners in elk formaat, met tekst die altijd leesbaar blijft.

Begin met ontwerpen, gratis

Vragen die mensen stellen

What should a changelog page include?

A header on one ground, then entries newest first. Each one has a version, a date, a customer-language title, its own address, and only the groups that have lines: Added, Changed, Deprecated, Removed, Fixed, Security.

How long should a changelog entry be?

One sentence of about three to seven words on the card, then a few lines on the page, one change each. Link out when a change needs a guide.

What size is a changelog share image?

1200×630 pixels. That is the Open Graph size most platforms use. Keep the title in the centre, because some apps crop the preview toward a square.

Should every commit appear in the changelog?

No. Publish what a customer would notice: an addition, a change in behaviour, a removal, a fix or a security patch. Refactors and ticket numbers stay in the commits.

How do I keep a year of releases looking like one product?

Keep one ground, one type scale and one corner for the name. Change only the version, the date and the title. In Gradiently, bulk create fills that card from a CSV or TSV, and it is part of Pro.

Deel deze gids

Geschreven door GradientlyGeverifieerd Gradiently-account

Het team achter Gradiently, een ontwerptool rond Marks: levende kleurverlopen die alles wat je ontwerpt op jou laten lijken.

Bekijk ons profiel

Op deze pagina

What a changelog page is forThe anatomy of one entryOne ground across the header and every cardThe share image for each releaseWrite the change in customer languageA card for every release, from one sheet

Deel deze gids

Volgende in Toepassingen

Newsletter header image: size, layout and the 3 second test

Lees verder

Alle gidsen over Toepassingen
Toepassingen

SaaS-branding: een look voor de lanceerdag en elke dag erna

5 min lezen

De lanceerdag krijgt de aandacht, maar een softwaremerk wordt vooral gebouwd in de honderd kleine posts erna: changelogs, linkpreviews, docs-headers en vacatures. Hier is een systeem waarmee ze allemaal op elkaar lijken.

Sociale media

Zo ontwerp je een aankondigingspost die mensen echt lezen

5 min lezen

Aankondigingen mislukken op een voorspelbare manier: de opwinding is groot en de feiten zijn klein. Zo zet je het nieuws voorop en zorg je dat de datum niet te missen is.

Werken met Gradiently

Ontwerpen in bulk maken vanuit spreadsheetrijen in Gradiently

5 min lezen

Veertig woningadvertenties, een termijn aan lestijden, een menu dat wekelijks wisselt. Als de opmaak gelijk blijft en alleen de woorden veranderen, hoort een spreadsheet het typewerk te doen.

Vind de look die alleen van jou is.

Elke Mark is een levende achtergrond met één eigenaar. Probeer een beschikbare Mark en claim de jouwe als het goed voelt.

Begin met ontwerpenBekijk het lanceringsaanbod

Marks nog te claimen

50van 1.000

950 tot nu toe geclaimdVind de jouwe

Controleer een certificaat

Typ een certificaatnummer of de code van een Mark om te zien wie hem bezit.

Werkt met ChatGPT en Claude

Vraag je AI om een ontwerp. Hij maakt het in jouw Mark, klaar om te bewerken.

ChatGPTClaude
Zo verbind je

Product

  • Markt
  • Verkennen
  • Prijzen
  • Lanceringspakketten
  • Certificaten

Leren

  • Praktijkgids
  • Helpcentrum
  • Wat is er nieuw

Ontwikkelaars

  • Overzicht
  • ChatGPT en Claude
  • API-referentie
  • API-keys

Bedrijf

  • Over ons
  • Contact
  • Inloggen

Juridisch

  • Voorwaarden
  • Privacy
  • Terugbetalingen
  • Mark-bescherming
  • Cookies
  • Alle beleidsstukken
Beweeg over de letters. Elke letter draagt een echte Mark.Raak een letter aan om zijn Mark te zien.Eén naam. Tien Marks erin.
© 2026 Gradiently