MarkedetUdforskPrøv
Priser
Log indStart
DesignguidenAnvendelser
Anvendelser

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.

GradientlyVerificeret Gradiently-konto·20. oktober 2026·7 min. læsning
Forside: Choral Bell · GR·RRB2·58

Denne guide findes ikke på dit sprog endnu, så her er den på engelsk.

Kort fortalt

  • 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.
På denne side
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.

Design med en levende gradient

Opslag, stories, slides og bannere i alle størrelser, med tekst der altid kan læses.

Begynd at designe, gratis

Spørgsmål, folk stiller

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.

Del denne guide

Skrevet af GradientlyVerificeret Gradiently-konto

Holdet bag Gradiently, et designværktøj bygget om Marks: levende gradienter, der får alt, du designer, til at ligne dig.

Se vores profil

På denne side

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

Del denne guide

Næste om Anvendelser

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

Læs videre

Alle guides om Anvendelser
Anvendelser

SaaS-branding: et udtryk til lanceringen og hver dag efter

5 min. læsning

Lanceringsdagen får opmærksomheden, men et softwarebrand bygges mest i de hundrede små opslag bagefter: changelogs, linkforhåndsvisninger, dokumentationsheadere og jobopslag. Her er et system, der får dem alle til at passe sammen.

Sociale medier

Sådan designer du et opslag med nyheder, som folk faktisk læser

5 min. læsning

Nyhedsopslag fejler på en forudsigelig måde: begejstringen er stor, og fakta er små. Sådan sætter du nyheden først og gør datoen umulig at overse.

Sådan bruger du Gradiently

Opret designs i bulk fra regnearksrækker i Gradiently

5 min. læsning

Fyrre boligannoncer, et semesters holdtider, et menukort, der skifter hver uge. Når layoutet er det samme, og kun ordene ændrer sig, bør et regneark klare tastearbejdet.

Find det look, der kun er dit.

Hver Mark er en levende baggrund med én ejer. Prøv en ledig Mark, og sikr dig din, når det føles rigtigt.

Begynd at designeSe lanceringstilbuddet

Marks tilbage at sikre sig

50af 1.000

950 sikret indtil nuFind din

Tjek et certifikat

Skriv et certifikatnummer eller en Marks kode for at se, hvem der ejer den.

Virker med ChatGPT og Claude

Bed din AI om et design. Den laver det i din Mark, klar til at redigere.

ChatGPTClaude
Sådan forbinder du

Produkt

  • Markedet
  • Udforsk
  • Priser
  • Lanceringspakker
  • Certifikater

Lær

  • Designguiden
  • Hjælpecenter
  • Nyheder

Udviklere

  • Oversigt
  • ChatGPT og Claude
  • API-reference
  • API-nøgler

Virksomhed

  • Om os
  • Kontakt os
  • Log ind

Juridisk

  • Vilkår
  • Privatliv
  • Refusion
  • Mark-beskyttelse
  • Cookies
  • Alle politikker
Bevæg dig hen over bogstaverne. Hvert af dem bærer en ægte Mark.Rør ved et bogstav for at se dets Mark.Ét navn. Ti Marks inden i.
© 2026 Gradiently