Send post title and CTA as JSON, get back a 1200x630 PNG sized for the Facebook feed.
Local businesses, e-commerce stores, and agencies running Facebook pages use the Facebook post image API to ship feed cards without designing each one in Canva. The 1200x630 ratio matches Facebook's feed share image recommendation, and the layout reads cleanly on both desktop and mobile feed views. You post the title, eyebrow, and CTA copy as JSON, and the response holds a PNG ready to attach to a page post, scheduled via Meta Business Suite or the Graph API.
curl -X POST https://app.html2img.com/api/v1/templates/facebook-post \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Doors open Saturday \u2014 first 50 guests get a free print","subtitle":"Join us at the studio launch from 11am to 6pm.","eyebrow":"GRAND OPENING","cta":"RSVP at studioink.co/launch","background_color":"#1E3A8A","accent_color":"#F59E0B"}'
A single cURL call to render a Facebook 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
Facebook Post Image API reference.
Setting up your key is covered in the
authentication guide.
View the Facebook Post Image API reference: inputs, defaults, error responses and cURL, PHP, Node and Python code samples. Read the docs.
Shopify and WooCommerce stores that promote individual products on Facebook benefit from per-SKU images rather than a stock store banner. Loop through your featured products, render a card for each with the product name and CTA, and queue the posts in Meta Business Suite. Riverside Bakery promotes 4 products per week through this flow, and each post performs better than the previous era of sharing the storefront photo with a generic caption.
Local news pages benefit from a clean editorial card per article in addition to the link unfurl. Render with the headline, byline, and section badge, attach to the page post, and the result reads as published journalism rather than a personal share. Northwind Weekly uses this for 12 articles per week and the engagement on the page has roughly doubled since the rollout.
Community pages and venues promoting events publish reminder cards in the lead-up to each date. Render with the event title, the date, and a CTA to RSVP, schedule across the campaign window, and attendance climbs because supporters see the event multiple times before committing. The Type Conference posts 8 reminder cards across the 6 weeks before the event.
Agencies managing 12+ client pages need a system that produces brand-consistent posts at scale. Use this endpoint with per-client accent colors, logos, and fonts, and the agency can ship a week's worth of posts for every client in a single afternoon. Halberd Software's social agency arm publishes 240 posts per week for 18 clients via this pipeline.
Coffee shops, salons, and small retailers can post offer cards without booking a designer for each promotion. Render with the offer headline, expiry, and CTA, attach to the page post, and the card carries enough information that interested customers can act without needing to message the page. Linden & Co's clients run promotions monthly through this flow.
Matches the spec at Meta feed share image guidelines.
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 1200x630 PNG, or as a PDF document if you set format to pdf.
Cache it, embed it in your page, attach it to an email.
Facebook removed the 20 percent text rule in 2020, but ad-delivery algorithms still favor images with less text. Keep on-image copy concise (under 30 words across title and CTA) so paid distribution stays cost-effective.
A link share unfurl reads the og:image of the destination URL, not the image attached to the post. For link previews, use the open-graph-image template and set og:image on the destination page, since post-attached images do not appear when a link is shared.
Mobile feed crops at the top and bottom while desktop preserves the full 1.91:1. Keep the focal area centered vertically so both crops show the headline and brand mark. Test on both surfaces before scheduling a campaign.
A quick summary of what the Facebook 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 |
cta | string | 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 square images sized for the Instagram feed
Vertical 9:16 covers for Instagram and TikTok stories
Polished share images sized for LinkedIn feed posts
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 Facebook post image be?
Use 1200x630 (1.91:1) for feed posts. The 1080x1080 size works for square posts, and 1080x1920 fits Stories. This template renders the 1200x630 size that performs well in the standard feed.
Is there a 20 percent text rule?
Facebook removed the strict text-to-image rule in 2020. Ad delivery still favors images with less text, so keep on-image copy under 30 words for paid use. Organic posts have more flexibility but readability still matters.
Should I use this for link share previews?
No, link previews read the og:image meta tag of the linked URL. Use the open-graph-image template for the destination page's share artwork, and reserve this template for images attached directly to a post.
Will it look right on mobile?
Yes, mobile and desktop both display 1.91:1 in feed, with mobile applying a small top-and-bottom crop. The template centers key content vertically so both crops show the headline. Test before going live with a campaign.
What is the file size limit?
Facebook supports up to 30 MB but recommends under 8 MB for fast loading. This template renders between 60 KB and 180 KB by default, so the file size never approaches the cap. Teams that file campaign creative as documents can also request format: "pdf" for an A4 copy; the upload to Facebook itself stays a PNG.
Can I use this for Facebook Ads?
Yes, 1200x630 fits most ad placements including feed, in-stream, and right-column. Ad copy still goes in the post text rather than overlaying the image, so keep on-image text minimal to keep delivery costs low.
25 renders a month on the free tier. See the pricing page for higher-volume plans.