MarchéExplorerEssayer
Tarifs
Se connecterCommencer
Guide pratiqueCas d’usage
Cas d’usage

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.

GradientlyCompte Gradiently vérifié·20 octobre 2026·7 min de lecture
Couverture : Choral Bell · GR·RRB2·58

Ce guide n’est pas encore disponible dans votre langue, le voici donc en anglais.

L’essentiel en bref

  • 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.
Sur cette page
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.

Créez avec un dégradé vivant

Posts, stories, diapositives et bannières dans tous les formats, avec un texte toujours lisible.

Commencer à créer, gratuit

Les questions qu’on nous pose

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.

Partager ce guide

Écrit par GradientlyCompte Gradiently vérifié

L’équipe derrière Gradiently, un outil de création construit autour des Marks : des dégradés vivants qui donnent à tout ce que vous créez votre propre signature.

Voir notre profil

Sur cette page

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

Partager ce guide

À suivre dans Cas d’usage

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

Pour aller plus loin

Tous les guides : Cas d’usage
Cas d’usage

Branding SaaS : un style pour le lancement et tous les jours d’après

6 min de lecture

Le jour du lancement attire l’attention, mais une marque de logiciel se construit surtout dans la centaine de petits posts qui suivent : changelogs, aperçus de liens, en-têtes de doc et offres d’emploi. Voici un système pour les accorder tous.

Réseaux sociaux

Concevoir un post d’annonce que l’on lit vraiment

5 min de lecture

Les annonces échouent de façon prévisible : l’enthousiasme est grand et les faits sont petits. Voici comment mettre la nouvelle en premier et rendre la date impossible à rater.

Utiliser Gradiently

Créer des visuels en série depuis un tableur dans Gradiently

6 min de lecture

Quarante annonces immobilières, un trimestre d’horaires de cours, un menu qui change chaque semaine. Quand la mise en page reste la même et que seuls les mots changent, c’est au tableur de taper.

Trouvez le style qui n’est qu’à vous.

Chaque Mark est un fond vivant avec un seul propriétaire. Essayez un Mark encore disponible et réservez le vôtre quand vous le sentez.

Commencer à créerVoir l’offre de lancement

Marks encore à réserver

50sur 1 000

950 réservés à ce jourTrouver le vôtre

Vérifier un certificat

Saisissez un numéro de certificat ou le code d’un Mark pour voir à qui il appartient.

Fonctionne avec ChatGPT et Claude

Demandez une création à votre IA. Elle la réalise dans votre Mark, prête à modifier.

ChatGPTClaude
Comment se connecter

Produit

  • Marché
  • Explorer
  • Tarifs
  • Packs de lancement
  • Certificats

Apprendre

  • Guide pratique
  • Centre d’aide
  • Nouveautés

Développeurs

  • Vue d’ensemble
  • ChatGPT et Claude
  • Référence de l’API
  • Clés API

Entreprise

  • À propos
  • Nous contacter
  • Se connecter

Mentions légales

  • Conditions
  • Confidentialité
  • Remboursements
  • Protection des Marks
  • Cookies
  • Toutes les politiques
Parcourez les lettres. Chacune porte un vrai Mark.Touchez une lettre pour voir son Mark.Un seul nom. Dix Marks à l’intérieur.
© 2026 Gradiently