# Announce every GitHub release with a branded card

> When you publish a GitHub release, render a card with the version and highlights and post it to Discord, Slack, X or LinkedIn. With n8n, Zapier or a GitHub Action.

- **URL**: https://templated.io/workflows/github-release-announcement-cards/

---

Tag the release and the announcement is done: a card with the version and the highlights goes to your community channels.

[Start free](https://app.templated.io/signup) · [See the setup](https://templated.io/workflows/github-release-announcement-cards/#how-to-run)

50 free credits. No credit card required.

1. When

   GitHub

   Release published

2. Templated

   Render PNG

   1200 × 630 release card

3. Then

   Social channels

   Discord, Slack, X, LinkedIn

## At a glance

Open-source projects and developer tools ship often, and each release deserves an announcement that people notice in a busy Discord or timeline.

GitHub fires an event when a release is published. Catch it with n8n, Zapier or a GitHub Action, render a card with the version name and the first highlights, and post it to your channels with the release link.

- Trigger

  GitHub: Release published

- Output

  PNG, 1200 × 630 release card

- Delivered to

  Social channels: Discord, Slack, X, LinkedIn

- Run it with

  REST API, n8n, Zapier

- Cost

  1 credit per image (each page of a multi-page template counts as one)

- Free plan

  50 credits, no credit card required

## How it works

Three steps, from the event to the finished file.

1. ### Publish the release

   The release event carries the tag, the name, the notes and the URL.

2. ### Templated renders the card

   Version, title and two or three highlights fill your template.

3. ### Announced

   The card goes to Discord, Slack, X or LinkedIn with the release link.

## Map your data to the template

Each dynamic layer in your template gets its value from one field. Name your layers like this, or map whatever names you use.

| Template layer | Comes from | Example |
| - | - | - |
| version | release.tag\_name | v2.4.0 |
| title | release.name | Faster builds, new CLI |
| highlights | First lines of release.body | Parallel builds · Plugin API |
| repo | repository.full\_name | acme/toolkit |

Text layers take `text`, image layers take `image_url`. You can also change colors, hide layers or swap fonts per render. [See every layer property](https://templated.io/docs/renders/create/).

## Templates for this workflow

Start from one of these and make it yours in the editor, import a Canva design, or describe one to the AI template generator.

- ![Blue Dynamic Simple Open Graph Template preview](https://templated-assets.s3.amazonaws.com/public/thumbnail/dcf19ca8-cf4f-46bd-95ec-db10b5e38809.webp)

  ### [Blue Dynamic Simple Open Graph Template](https://templated.io/templates/open-graph/blue-dynamic-simple-open-graph-template/)

- ![Colorful Gradient Open Graph Template preview](https://templated-assets.s3.amazonaws.com/public/thumbnail/ae775076-8f90-4a2b-8455-79b452c62981.webp)

  ### [Colorful Gradient Open Graph Template](https://templated.io/templates/open-graph/colorful-gradient-open-graph-template/)

- ![Tweet Template Generic Square preview](https://templated-assets.s3.amazonaws.com/public/thumbnail/9c4f7280-bfa8-4bb9-81ed-32df52a10394.webp)

  ### [Tweet Template Generic Square](https://templated.io/templates/social-media/tweet-template-generic-square/)

[Browse all templates](https://templated.io/templates/) · [Generate one with AI](https://templated.io/ai-template-generator/)

## When to use it

- Open-source maintainers announcing releases to their community.
- Developer tools with a public changelog.
- Internal platforms announcing releases in Slack.

## Tips

- Release notes are long. Take the first two bullet points for the card and link to the full notes.
- Skip pre-releases with a filter on `release.prerelease`.
- Use the same card as the release's Open Graph image on your changelog page.

## How to run it

Pick the tool you already use. The first one is the quickest way to set this up.

### REST API

From your own code

1. Add a GitHub Actions workflow that runs `on: release: types: [published]`.
2. In a step, call `POST /v1/render` with the release fields (sample below), using a `TEMPLATED_API_KEY` secret.
3. Post the returned `url` to a Discord or Slack webhook in the next step.

cURL

```
curl -X POST https://api.templated.io/v1/render \
  -H "Authorization: Bearer $TEMPLATED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "template": "YOUR_TEMPLATE_ID",
  "format": "png",
  "layers": {
    "version": {
      "text": "v2.4.0"
    },
    "title": {
      "text": "Faster builds, new CLI"
    },
    "highlights": {
      "text": "Parallel builds · Plugin API"
    },
    "repo": {
      "text": "acme/toolkit"
    }
  }
}'
```

[API documentation](https://templated.io/docs/)

### n8n

Cloud or self-hosted

1. Start with a **GitHub Trigger** on the **release** event.
2. Add the **Templated** node (**Create a Render**).
3. Post with the **Discord**, **Slack** or **X** node.

[More about n8n](https://templated.io/integrations/n8n/)

### Zapier

No-code Zap

1. Trigger on **GitHub › New Release**.
2. Add **Templated › Create Render**.
3. Post with **Discord**, **Slack** or **LinkedIn**.

[More about Zapier](https://templated.io/integrations/zapier/)

## Related workflows

- ### [Give every blog post and page its own Open Graph image](https://templated.io/workflows/og-images-for-blog-posts/)

  Stop sharing every link with the same generic preview. Each page gets an OG image with its own title, in bulk for old pages and automatically for new ones.

  Spreadsheet generation, REST API, Inbound webhooks

- ### [Share every new blog post with its own branded image](https://templated.io/workflows/blog-posts-to-social-images/)

  Publish the article and you are done: the RSS feed triggers a branded share image with the title, and the post goes out on your channels.

  Run with: Zapier, Make, n8n

- ### [Turn feedback form answers into testimonial graphics](https://templated.io/workflows/testimonial-cards-from-forms/)

  Point your form's webhook at Templated. Every answer becomes a testimonial card with the quote, name, role and photo.

  Inbound webhooks, Zapier, n8n

[See all workflows](https://templated.io/workflows/)

## Set up your first workflow today

Create a template, connect your tool and render your first image in minutes.

50 free credits. No credit card required.

[Start free](https://app.templated.io/signup)
