Send post title and author details as JSON, get back a 1200x627 PNG ready for the LinkedIn feed.
B2B SaaS marketing teams and thought leaders use the LinkedIn post image API to attach share cards to long-form posts and case studies. The 1200x627 size matches LinkedIn's documented dimensions for feed share images, which differ subtly from Facebook's 1200x630. You post the title, eyebrow text, optional author block, and brand inputs as JSON, and the response holds a PNG ready to attach to a feed post or schedule via your LinkedIn ads tooling.
curl -X POST https://app.html2img.com/api/v1/templates/linkedin-post \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Five lessons from scaling a B2B SaaS to $10M ARR","subtitle":"What I would have done differently in years one through three.","eyebrow":"GROWTH PLAYBOOK","author_name":"Priya Natarajan","author_role":"CEO, Northwind Labs","author_avatar_url":"https://i.pravatar.cc/160?img=47","background_color":"#FFFFFF","accent_color":"#0A66C2"}'
A single cURL call to render a LinkedIn Post Image as a PNG. Add "format": "pdf" to the payload to get a PDF instead. For the full PHP, Node and Python equivalents, plus every input the template accepts, see the
LinkedIn Post Image API reference.
Setting up your key is covered in the
authentication guide.
View the LinkedIn Post Image API reference: inputs, defaults, error responses and cURL, PHP, Node and Python code samples. Read the docs.
Case study posts perform better with custom artwork than with the default link unfurl. Render with the case study client name, the headline metric ("3x faster onboarding", "70 percent cost reduction"), and your accent_color, then attach to the LinkedIn post that links to the case study page. Halberd Software publishes 4 case study posts per quarter through this flow, and click-throughs to the case study page run roughly 2.5x the rate of plain link posts.
Agencies that highlight client outcomes on LinkedIn benefit from per-client cards with the client logo and the headline result. Render with the client name, the win metric, and a small attribution mark, post on behalf of the agency or the client, and the agency feed reads as a portfolio of measurable outcomes. Wren Analytics' agency arm posts 12 client wins per month through this template.
Talent teams posting open roles benefit from cards that go beyond the LinkedIn job listing format. Render with the role title, the team, the location, and a CTA to apply, attach to the recruiter's post, and the role gets visibility in the connection feed without requiring readers to click through to a job board. Linden & Co posts 8 roles per month through this template.
Long-form essay writers on LinkedIn benefit from a hero card per essay, similar to how a magazine treats a feature. Render with the essay title, the author photo, and a small magazine-style label ("Essay", "Op-ed", "Analysis"), attach to the post, and the essay reads as published rather than as a casual update. Northwind Studio's founder publishes one essay per month through this format.
Event organizers running B2B conferences publish speaker announcements on LinkedIn in the lead-up to the event. Render a card per speaker with their name, role, talk title, and event date, attach to the announcement post, and the campaign reads as one structured speaker reveal. The Type Conference uses this for 28 speaker reveals across the 8-week pre-event campaign.
Matches the spec at LinkedIn share image dimensions.
These specifications describe the default PNG output. The template can also return a PDF document with selectable text through the HTML to PDF API: set format to pdf in the request. See the format parameter docs for how PDF output behaves.
POST to the template endpoint with the values you want rendered. Authenticate with your API key.
The template is rendered server-side as a 1200x627 PNG, or as a PDF document if you set format to pdf.
Cache it, embed it in your page, attach it to an email.
LinkedIn documents 1200x627 while Facebook documents 1200x630, so a single design at 1200x630 will get a 3-pixel rounding shift when LinkedIn re-encodes. Render at 1200x627 specifically for LinkedIn, and at 1200x630 for OG tags on the destination page.
Company page posts and personal posts use slightly different mobile crops in the LinkedIn app. Keep the focal area centered both vertically and horizontally so both surfaces show the headline. Test in the LinkedIn mobile app before scheduling a paid campaign.
LinkedIn document carousels use 1920x1080 PDFs rather than images. This template only handles single-image posts. For carousels, render each slide separately and assemble a PDF with a tool like ImageMagick or pdfkit on your side.
A quick summary of what the LinkedIn Post Image template accepts. The full reference, with example values and array shapes, is in the docs.
| Name | Type | Required |
|---|---|---|
title | string | Required |
subtitle | string | Optional |
eyebrow | string | Optional |
author_name | string | Optional |
author_role | string | Optional |
author_avatar_url | url | Optional |
logo_url | url | Optional |
background_color | string | Optional |
accent_color | string | Optional |
See the full inputs reference for descriptions, examples and validation rules.
Other templates in the social media category.
Bold share images sized for Facebook feed posts
Bold square images sized for the Instagram feed
Vertical 9:16 covers for Instagram and TikTok stories
Vertical 2:3 pins with strong typography that stand out in feed
Render a tweet-style card from supplied data — avatar, body, image, metrics
Generate share-ready images sized for Twitter/X posts
High-contrast 16:9 thumbnails optimized for click-through
A starting point from each of the other two template categories.
See the full template gallery for every design grouped by category.
What size should a LinkedIn post image be?
Use 1200x627 for feed share images and 1080x1080 for square posts. The LinkedIn docs specify 627, not 630, which differs from Facebook by 3 pixels. This template uses the documented 627 height.
Does it work for company pages?
Yes, both company page and personal post share images use the same 1200x627 dimensions. The renderer does not differentiate between them, so the same template serves both surfaces. Apply your company branding via accent_color and logo_url.
What about LinkedIn document carousels?
Carousels use 1920x1080 PDFs rather than images, so this template is not the right tool. Render each carousel slide separately at 1920x1080, then assemble the PDF with a tool like pdfkit or ImageMagick on your side, then upload as a document post.
Can I include hashtags on the image?
Hashtags belong in the post text rather than on the image. LinkedIn parses hashtags from the body for discoverability and topic association. Use the image purely for visual identity and put hashtags in the post composer.
Will it work for ads?
Yes, 1200x627 fits LinkedIn Sponsored Content placements. The same render serves organic posts and paid campaigns, so you do not need separate creative for each. Test ad performance with at least three accent_color variants to find the highest CTR card.
What is the file size limit?
LinkedIn caps post images at 10 MB. Default-DPI renders from this template land between 60 KB and 200 KB, well below the cap. Higher-DPI renders for retina displays can reach 1 MB but stay comfortable. Compliance teams archiving social creative can add format: "pdf" to receive the same artwork as an A4 document.
25 renders a month on the free tier. See the pricing page for higher-volume plans.