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.

social template

LinkedIn Post Image API

Send post title and author details as JSON, get back a 1200x627 PNG ready for the LinkedIn feed.

Get started free Read the LinkedIn Post Image API reference

LinkedIn Post Image template preview, a social image generated by the HTML to Image API

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.

API reference

View the LinkedIn Post Image API reference

Inputs, defaults, error responses and cURL, PHP, Node and Python code samples.

Read the docs →

Use cases

B2B SaaS sharing case studies

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 publishing client wins

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.

Recruiters posting roles

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.

Thought leaders sharing essay artwork

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.

Conferences promoting speakers

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.

Output specifications

Dimensions: 1200x627
Color space: sRGB
Transparency: Not supported
File size range: 60 KB to 200 KB

Matches the spec at LinkedIn share image dimensions.

How it works

Send a JSON payload

POST to the template endpoint with the values you want rendered. Authenticate with your API key.

We render the image

The template is rendered server-side as a 1200x627 PNG.

You get back a URL

Cache it, embed it in your page, attach it to an email.

Quick example

A single cURL call to render a LinkedIn Post Image as a PNG:

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"}'

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.

Common pitfalls

Mixing 627 and 630 across templates

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 and personal post crops differ on mobile

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.

Document carousels need a different format

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.

Inputs at a glance

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