These are real renders from the API with the example values in the table below. Switch the size above: the same template lays itself out for all 6 sizes — send size or sizes with the request.
For brands and giveaway apps posting the result of a contest. One to five winners stand on the stage; more are counted next to the prize. A winner without a photo gets their initials on an accent circle, long names and handles end in an ellipsis. Wide frames set all winners in one row; square and vertical frames break four or five into two rows, and three on a vertical frame put the first one on top.
Fields
Every field is optional. Long text shrinks to fit instead of overflowing; an image field takes a public URL that we fetch on our side.
| Field | Type | Description | Example |
|---|---|---|---|
title |
text | Heading above the stage, e.g. And the winners are…. default: And the winners are… | And the winners are… |
winners |
text |
Winners separated by ;, each as name|handle, e.g. Lena Sørensen|@lenaknits;Tomás Ruiz|@tomas.makes. Five are shown.
|
Lena Sørensen|@lenaknits;Tomás Ruiz|@tomas.makes;Aiko Tanaka|@aiko_draws |
prize |
text | What they won, in the pill at the bottom. | Each wins a pair of Studio Wireless Headphones |
avatar_1 |
image URL | Photo of the first winner. | https://example.com/images/avatar-woman.jpg |
avatar_2 |
image URL | Photo of the second winner. | https://example.com/images/avatar-man.jpg |
avatar_3 |
image URL | Photo of the third winner. | https://example.com/images/avatar-woman2.jpg |
avatar_4 |
image URL | Photo of the fourth winner. | — |
avatar_5 |
image URL | Photo of the fifth winner. | — |
logo |
image URL | Brand logo next to the title, square. | https://example.com/images/b07-aurora.png |
accent |
colour | Brand colour as hex, e.g. #6366f1. Drives buttons, highlights and the background glow. default: #f59e0b | #f59e0b |
theme |
dark | light | Colour scheme: dark or light. | — |
Render it with one request
Use the slug as template. The response holds the URL of the finished PNG; ?wait=true keeps the connection open until it is ready.
curl -X POST "https://shareglint.com/v1/images?wait=true" \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"template": "giveaway-winner",
"modifications": {
"title": "And the winners are…",
"winners": "Lena Sørensen|@lenaknits;Tomás Ruiz|@tomas.makes;Aiko Tanaka|@aiko_draws",
"prize": "Each wins a pair of Studio Wireless Headphones",
"avatar_1": "https://example.com/images/avatar-woman.jpg",
"avatar_2": "https://example.com/images/avatar-man.jpg",
"avatar_3": "https://example.com/images/avatar-woman2.jpg",
"logo": "https://example.com/images/b07-aurora.png"
}
}'Or paste a signed URL into og:image
For static sites, Webflow, Shopify and no-code tools: put the fields in the query string and sign it with your signing secret. The first request renders the image, every later one is a redirect to the cached file. How to compute the signature.
<meta property="og:image" content="https://shareglint.com/i/acc_YOUR_ACCOUNT_ID/giveaway-winner.png?prize=Each%20wins%20a%20pair%20of%20Studio%20Wireless%20Headphones&title=And%20the%20winners%20are%E2%80%A6&winners=Lena%20S%C3%B8rensen%7C%40lenaknits%3BTom%C3%A1s%20Ruiz%7C%40tomas.makes%3BAiko%20Tanaka%7C%40aiko_draws&s=YOUR_SIGNATURE">Make it yours
accent and theme change per request. For anything more, copy the template into your account: you get an ordinary HTML template with the same fields that you can edit in the dashboard or through the API. If the slug is free on your account, the copy takes it — your integrations switch to your version without changing a line.
curl -X POST "https://shareglint.com/v1/templates/library/giveaway-winner/copy" \
-H "Authorization: Bearer sk_live_YOUR_KEY"More Social media & creators templates
Video thumbnail
Creator thumbnail
Social post
Carousel cover
Carousel slide
Carousel end slide
Photo collage
Story new post
Reaction thumbnail
All 19 Social media & creators templates → · All templates →