adwarp

Start with 1 prompt

Paste it into Claude Code, Codex or Cursor. Your agent installs Adwarp, walks you through your LinkedIn app and checks the connection.

setup prompt
Set up Adwarp for me. It's the open-source ad agent for LinkedIn Ads and Google Ads: https://github.com/adwarp-dev/adwarp

1. Check that Node.js 20 or newer is installed.
2. Walk me through creating my own LinkedIn developer app with the Advertising API product: https://github.com/adwarp-dev/adwarp/blob/main/docs/linkedin-app.md
3. Save the app's client ID and secret to ~/.adwarp/config.json as clientId and clientSecret.
4. Run "npx -y adwarp auth login" and wait while I approve access in my browser.
5. Add Adwarp to the AI client I'm using right now as an MCP server that runs "npx -y adwarp mcp". In Claude Code that's: claude mcp add adwarp -- npx -y adwarp mcp
6. Check the connection by listing my ad accounts, then save the one I pick as defaultAccountId in ~/.adwarp/config.json.

Don't create or change anything in my ad accounts during setup. LinkedIn campaigns start as drafts, so nothing spends until I turn it on.
adwarp
GitHub

Start with 1 prompt

Paste it into Claude Code, Codex or Cursor. Your agent installs Adwarp, walks you through your LinkedIn app and checks the connection.

setup prompt
Set up Adwarp for me. It's the open-source ad agent for LinkedIn Ads and Google Ads: https://github.com/adwarp-dev/adwarp

1. Check that Node.js 20 or newer is installed.
2. Walk me through creating my own LinkedIn developer app with the Advertising API product: https://github.com/adwarp-dev/adwarp/blob/main/docs/linkedin-app.md
3. Save the app's client ID and secret to ~/.adwarp/config.json as clientId and clientSecret.
4. Run "npx -y adwarp auth login" and wait while I approve access in my browser.
5. Add Adwarp to the AI client I'm using right now as an MCP server that runs "npx -y adwarp mcp". In Claude Code that's: claude mcp add adwarp -- npx -y adwarp mcp
6. Check the connection by listing my ad accounts, then save the one I pick as defaultAccountId in ~/.adwarp/config.json.

Don't create or change anything in my ad accounts during setup. LinkedIn campaigns start as drafts, so nothing spends until I turn it on.

LinkedIn ad specs and sizes for every format, checked against LinkedIn

1 table for 13 formats and Lead Gen Forms, the 12 places LinkedIn's own pages disagree, a character counter and blank size templates.

By Updated 13 min read

LinkedIn's recommended single image ad size is 1200 x 628 pixels (1.91:1), with 1200 x 1200 for square and 720 x 900 for vertical, and carousel cards are 1080 x 1080. Intro text shows 150 characters before it cuts off and headlines show 70, and every number below was checked against LinkedIn's own spec pages on November 7, 2026.

LinkedIn ad specs for every format

1 row per format, plus Lead Gen Forms. "Shown" is where the feed truncates text and "max" is the most a field accepts. Each format name links to the LinkedIn page its numbers come from.

Format, Ratios, Recommended pixels, Files and maximum size, Intro text, shown / max, Headline, shown / max, Call to action
FormatRatiosRecommended pixelsFiles and maximum sizeIntro text, shown / maxHeadline, shown / maxCall to action
Single image1.91:1, 1:1, 4:51200 x 628, 1200 x 1200, 720 x 900JPG, PNG or GIF, 5 MB150 / 3,00070 / 20010 labels
Video16:9, 1:1, 4:5, 9:161920 x 1080, 720 x 900, 720 x 1280MP4, 75 KB to 500 MB150 / 3,00070 / 20010 labels
Carousel1:11080 x 1080 a cardJPG, PNG or static GIF, 10 MB a card150 / 25545 a cardLead Gen Form only
DocumentVertical, horizontal, squareNot givenPDF, DOC, DOCX, PPT, PPTX, 100 MB150 / 3,00070 / 200Not listed
Event4:1From the Event pageNothing to upload600 maxEvent name 255Not listed
Thought leaderThe post's ownSingle image or video specsThe author's postThe author's postNone, rolling outNone, rolling out
Article and newsletterSingle image specsSingle image specsThe author's postNoneNoneUnlock Article
Connected TV16:91920 x 1080MP4, 500 MBNot listedNot listedNot listed
Conversation1:1 image250 x 250, 300 x 250 bannerJPG or PNG, 5 MB, banner 2 MB8,000 a messageNone25 characters, 5 a message
MessageBanner only300 x 250 bannerJPG, PNG or static GIF, 2 MBBody 1,500Subject 6020 characters
Text1:1100 x 100JPG or PNG, 2 MBDescription 7525None
Spotlight1:1 logo100 x 100 logo, 300 x 250 backgroundJPG or PNG, background 2 MBDescription 705018 characters
Follower1:1 logo100 x 100 logoJPG or PNGDescription 7050Preset
Lead Gen FormForm image552 x 200Not givenDetails 16060Preset
Fig. 01The 5 ratios behind most LinkedIn ads, drawn to scale at the same height, with the 1.91:1 landscape image in orange and the 4:1 event banner below.

Downloads

14 rows, with the LinkedIn source for each

Blank PNG templates

  • 1200 x 628Single image, landscape
  • 1200 x 1200Single image, square
  • 720 x 900Single image or video, vertical
  • 1080 x 1080Carousel card
  • 1920 x 1080Video or connected TV
  • 720 x 1280Video, 9:16
  • 300 x 250Banner or spotlight background
  • 100 x 100Text ad image or logo
  • 552 x 200Lead Gen Form image

Built in your browser from the table above. Sizes come from the LinkedIn Help pages cited in the table, checked November 7, 2026.

Single image ad specs

LinkedIn's single image Help page is the fullest source. The single image spec page repeats most of it, and its 2 differences are in the table near the end.

Fig. 02A single image ad in the feed with both of LinkedIn's cut-offs marked: the intro text truncates at 150 characters and the headline at 70.

Sizes and ratios

Ratio, Recommended, Minimum, Maximum, Serves on
RatioRecommendedMinimumMaximumServes on
1.91:1 horizontal1200 x 628640 x 3607680 x 4320Desktop and mobile
1:1 square1200 x 1200360 x 3604320 x 4320Desktop and mobile
4:5 vertical720 x 900360 x 6402430 x 4320Mobile only
Fig. 03The 3 single image ratios drawn as feed ads of the same width, where the 4:5 one runs tallest and serves on mobile only.

The spec page calls 1:1 the recommended ratio for desktop and mobile. A 1:1.91 vertical image (628 x 1200) uploads but gets borders on both sides, which 4:5 avoids. Files can be JPG, PNG or GIF up to 5 MB, with animated GIFs capped at 250 frames.

Fig. 04A 628 x 1200 image picks up borders on both sides, and a 720 x 900 image at 4:5 fills the same space.

LinkedIn scales oversized images down for you. An image under 401 pixels wide shows as a thumbnail instead.

Text limits

Field, Shown before truncation, Maximum
FieldShown before truncationMaximum
Intro text1503,000, with up to 10 emojis
Headline70200
Description100300
Ad nameNot shown to members255
Destination URLNot shown2,000

The 150 includes spaces, emojis and punctuation, and a link over 23 characters in the intro text gets shortened. The description shows only when the image is under 200 pixels wide or the ad runs on the LinkedIn Audience Network.

Character counter

150 shown / 3,000 max

Paste or type to count

70 shown / 200 max

Paste or type to count

Counts every character, spaces, emojis and punctuation included. The preview cuts at the shown limit, and text after the orange bar is cut off in the feed. Video intro text: LinkedIn's video spec page caps it at 600, so stay under 600 for video.

Limits: single image, video, document and carousel Help pages, checked November 7, 2026.

1200 x 627 or 1200 x 628?

The Ads Guide says 1200x627 pixels, while the spec page and the Help page say 1200 x 628. Both round to 1.91:1 and sit far inside the 640 x 360 to 7680 x 4320 range. Use 1200 x 628, the number on 2 of LinkedIn's 3 pages.

Call to action buttons

The button is optional, and the spec page lists 10 labels: Apply, Download, View Quote, Learn More, Sign Up, Subscribe, Register, Join, Attend and Request Demo. The API spells them as values like LEARN_MORE (see the last section).

Fig. 05A single image ad with its optional button, next to the 10 labels the spec page lists for it.

Video ad specs

The video Help page and the video spec page agree on sizes and file limits. They part ways on the intro text maximum and the frame rate.

Fig. 06Video length on a log scale from 3 seconds to 30 minutes: LinkedIn recommends 15 to 30 seconds, and anything shorter than 30 loops.

Sizes

Ratio, Recommended, Minimum, Maximum
RatioRecommendedMinimumMaximum
16:9 horizontal1920 x 1080 or 1200 x 675640 x 3601920 x 1080
1:1 squareNot given360 x 3601920 x 1920
4:5 vertical, LinkedIn's recommended ratio720 x 900360 x 4501080 x 1350
9:16 vertical720 x 1280360 x 6401080 x 1920

The spec page allows a 5% aspect ratio tolerance. Nothing wider than 16:9 is accepted, and the Help page's example is a 1920 x 360 file that "is not tall enough for an ad."

Fig. 07The 4 video ratios at the same width on a phone, with LinkedIn's recommended 4:5 in orange, and a 1920 x 360 file too wide to be accepted.

File, length and sound

  • MP4 from 75 KB to 500 MB. Apple ProRes isn't supported.
  • 3 seconds to 30 minutes, with 15 to 30 seconds recommended. A video under 30 seconds loops until it reaches 30 seconds of playback.
  • H.264 or VP8, under 30 frames per second, with AAC or MPEG4 audio under 64 kHz.
  • Captions as an SRT file, plain text only.
  • An optional thumbnail, JPG or PNG up to 2 MB, at the video's own ratio and resolution.
  • 25 uploads per 24 hours in Campaign Manager, from a desktop only.
Fig. 08The 3 files behind a video ad: the MP4 itself, an optional thumbnail image and an optional SRT file for the captions.

Text limits

Intro text shows 150 characters and the headline 70, with a 200-character headline maximum. For the intro text maximum, the Help page says 3,000 and the spec page says 600. Write under 600 and both are satisfied.

The same Help page contradicts itself on emojis. It allows 10 in the intro text, then warns further down that an ad "might be rejected" for non-standard text, including more than 4 emojis. Keep it to 4.

A carousel holds 2 to 10 cards at 1080 x 1080, up to 4320 x 4320 and 10 MB a card (carousel Help page). The feed shows each card at 312 x 312, so keep type on the cards large. Video cards aren't supported.

Fig. 09Carousel cards are uploaded at 1080 x 1080 and shown in the feed at 312 x 312, under a third of the upload's width.

Intro text shows 150 characters and stops at 255. Card headlines get 45 characters whether the ad links to a URL or a Lead Gen Form, and they truncate after 2 lines. The Help page accepts JPG, PNG and non-animated GIF, while the carousel spec page says JPG or PNG.

Fig. 10A carousel ad in the feed, with the intro text cut at 150 characters and 45 for each card's headline.

Check every card before you save the ad, because the cards can't be edited after that. Buttons only appear on carousels that use a Lead Gen Form (Sponsored Content specifications).

Document ad specs

Document ads take PDF, DOC, DOCX, PPT or PPTX up to 100 MB, 300 pages or 1 million words, and up to 5 documents per upload. With the lead generation objective only PDF works. The document spec page recommends staying under 10 pages.

Fig. 11A document ad as a stack of pages: 300 is the ceiling, and LinkedIn recommends fewer than 10.

Intro text shows 150 characters (3,000 maximum) and the headline 70 (200 maximum). The headline starts out as the file name, so upload deck_final_v7.pdf without renaming it and that is what members read under your ad. LinkedIn asks for layered PDFs to be flattened and every page fitted to 1 size. Video and animation show as stills, and links work only after a download.

Fig. 12A document ad with its page count under the preview, and the uploaded file's name standing in as the headline until you change it.

Thought leader ad specs

A thought leader ad sponsors a member's own post, so the post's format decides the specs (Thought Leader Ads Help).

Fig. 13Text, image, video, document, article and newsletter posts can run as thought leader ads, while polls, celebrations, multi-image posts and reposts can't.

Which posts qualify

Public text, single image, video, document, article and newsletter posts qualify, whether they come from employees or from members at any connection degree. Collaborative posts count too, as do attendee posts about a LinkedIn Live event your Page created. Celebrations, polls and multi-image posts aren't eligible, and a repost can't be sponsored, so you'd ask the original author instead.

The author's profile has to show their full name, and image and video posts must meet the specs above.

Add-ons for a sponsored post

The thought leader spec page still says you can't add a headline or intro text and that there's no URL field or button. Links in the author's own text stay clickable, and event thought leader ads do get a button.

LinkedIn's Help page for authors approving a request, updated in early November 2026, describes 4 additions to the sponsored version of an approved post: a headline, a call to action button, a destination link and a Lead Gen Form. LinkedIn says it is "gradually making this feature available," so check your own Campaign Manager before planning around it.

Fig. 14A member's post as a thought leader ad, and the 4 additions LinkedIn is rolling out for it: a headline, a button, a destination link and a Lead Gen Form.

Event and article ad specs

Event ads promote a LinkedIn Event page and pull their 4:1 image from it, so there's nothing to upload. Intro text runs to 600 characters and the optional event name to 255. The URL has to point to a LinkedIn Event page (event ad spec page).

Fig. 15Event ads reuse the Event page's 4:1 banner, and article and newsletter ads reuse the article's own image under the single image specs.

Article and newsletter ads sponsor an article or newsletter already published on LinkedIn. They follow the single image specs and take no headline, intro text or URL of your own. With the lead generation objective, which works for articles but not newsletters, the ad gets an "Unlock Article" button, and other objectives show none (article and newsletter spec page).

Connected TV ad specs

Connected TV ads run on streaming platforms, and a video has to meet the specs below to be eligible.

Fig. 16Connected TV lengths on a 90-second dial: 7 lengths are accepted and the 4 LinkedIn recommends (6, 15, 30 and 60 seconds) are in orange.
Spec, Requirement
SpecRequirement
Resolution1920 x 1080 recommended, 1280 x 720 accepted
File16:9 MP4, H.264, up to 500 MB
Length6, 15, 30, 45, 60, 75 or 90 seconds
Video bit rate15 to 40 Mbps recommended
Frame rateConstant, 23.98, 24, 25, 29.97 or 30
Audio2 channels, -23 integrated LUFS, 48 kHz, PCM or AAC, at least 192 Kbps

Some inventory may not take 75 or 90 seconds, so keep a 60-second cut ready. The Help page puts the minimum bit rate at 1.2 Mbps and the connected TV spec page at 12 Mbps, and 15 Mbps or more clears both.

Conversation and message ad specs

Both are Sponsored Messaging formats. A message ad is a single message, while a conversation ad opens with a message whose buttons lead to more messages.

Fig. 17A conversation ad branches from its intro message through up to 5 buttons a message, with 50 buttons as the limit for the whole conversation.
Field, Message ads, Conversation ads
FieldMessage adsConversation ads
Subject60None
Message1,5008,000 a message
Button text2025
ButtonsNot Interested added automatically5 a message, 50 a conversation, Not Interested included
LinksUp to 3Not listed
ImageNone250 x 250, JPG or PNG, 5 MB
Desktop banner300 x 250, 2 MB300 x 250, 2 MB
Footer and terms20,00020,000
Landing page URL1,024Not listed
Fig. 18A message ad next to a conversation ad, whose messages hold up to 5 buttons at 25 characters against the message ad's 20.

Members in the European Economic Area and Switzerland only receive either format if they opted in to Sponsored Messaging in their inbox.

Text, spotlight and follower ad specs

All 3 run in the right rail, and each has its own Help page: text ads, spotlight ads and follower ads.

Fig. 19Text, spotlight and follower ads sit in the narrow right rail beside the feed, with much shorter text limits than a feed ad.
Field, Text ads, Spotlight ads, Follower ads
FieldText adsSpotlight adsFollower ads
Image100 x 100, JPG or PNG, 2 MBLogo, 100 x 100 minimumLogo, 100 x 100 minimum
Headline255050
Description757070
Company nameNot listed2525
ButtonNone18Preset, such as Visit company
BackgroundNoneExactly 300 x 250, 2 MB or lessNone
Destination URL500500Your Page's tabs
Fig. 20Text, spotlight and follower ads with their headline and description limits, and the spotlight background that has to be exactly 300 x 250.

Lead Gen Form specs

A Lead Gen Form takes a 60-character headline, 160 characters of details and an optional image at 552 x 200. It can ask up to 12 questions, up to 3 of them custom at 100 characters each.

Fig. 21A Lead Gen Form with its 552 x 200 image on top and 12 question slots, the last 3 of them custom.

Privacy policy text runs to 2,000 characters, each of up to 5 disclosure checkboxes to 500, and the thank-you message to 300. The landing page URL after the form takes up to 2,000 characters.

Fig. 22A Lead Gen Form, its thank-you message of up to 300 characters and the landing page after it, whose URL can run to 2,000.

Where LinkedIn's own pages disagree

LinkedIn publishes specs in 3 places: Help Center articles, the spec pages on business.linkedin.com and the Ads Guide. On November 7, 2026 they conflicted in 12 places, 1 of them inside a single Help page. Where they differ, use the stricter number and the ad passes whichever page Campaign Manager follows.

Fig. 23The Help Center and the spec pages as 2 overlapping sets: a number that fits inside both limits passes either page.
Spec, Help Center says, Spec page or Ads Guide says, Use, Checked
SpecHelp Center saysSpec page or Ads Guide saysUseChecked
Single image landscape size1200 x 6281200x627 in the Ads Guide1200 x 6282026-11-07
Single image description100 shown, 300 maximum70, Audience Network only70 or fewer2026-11-07
Video intro text maximum3,000600Under 6002026-11-07
Video frame rateUnder 3030 recommended29.97 or lower2026-11-07
Video emojis10 allowed, more than 4 may be rejectedSame Help page4 or fewer2026-11-07
Carousel file typesJPG, PNG, static GIFJPG or PNGJPG or PNG2026-11-07
Document file types5 types3 in the Ads GuideAny of the 5, PDF for lead generation2026-11-07
Text ad headline2550 in the Ads Guide252026-11-07
Text ad URL length5002,000Under 5002026-11-07
Connected TV minimum bit rate1.2 Mbps12 Mbps15 Mbps or more2026-11-07
Thought leader documentsEligibleNot eligibleEligible, per the newer Help page2026-11-07
Thought leader buttonsRolling outNoneCheck your own account2026-11-07

Each time LinkedIn changes a number, a new row goes in with the date it was checked.

Creating ads through the API

Campaign Manager's labels aren't the API's field names. In the Posts API, intro text is commentary, the destination is contentLandingPage and the button is contentCallToActionLabel. The post schema takes 13 button values: the 10 Campaign Manager labels, SEE_MORE, and BUY_NOW and SHOP_NOW from version 202504.

Fig. 24Campaign Manager's field names on the left and the Posts API fields that hold them on the right, with the button field in orange.

The ad format is fixed when the ad set, which the API calls a campaign, is created. Every creative has to match it, and video, carousel and dynamic ad sets need it set at creation (Campaigns API). Campaign Manager won't change it after launch either (Edit an ad set).

Fig. 25An ad set's format is fixed when it's created, so a video ad set takes video creatives and refuses a single image.

If you edit a live ad's post through the API, the change doesn't show in Campaign Manager's editor, so new copy goes out as a new ad (Adwarp's ad tools).

Put it to work

LinkedIn Ads campaigns

Build LinkedIn campaigns, ad sets and ads from your terminal, created as drafts until you switch them on.

adwarp.dev/linkedin-ads/campaigns

By Stan Rymkiewicz, maintainer of adwarp. Published November 7, 2026.

FAQ

Questions Short answers, with sources.

Ask on GitHub
What size is best for a LinkedIn ad?

For a single image ad, 1200 x 628 pixels (1.91:1) is LinkedIn's recommended landscape size and 1200 x 1200 its recommended square. LinkedIn's spec page calls 1:1 the recommended ratio for desktop and mobile, while 720 x 900 vertical images serve on mobile only.

What are the recommended LinkedIn ad sizes for 2026?

Single image ads take 1200 x 628, 1200 x 1200 or 720 x 900, carousel cards 1080 x 1080, and video 1920 x 1080, 720 x 900 or 720 x 1280. Each matches LinkedIn's Help Center as checked on November 7, 2026.

Is the LinkedIn ad size 1200 x 627 or 1200 x 628?

LinkedIn's Ads Guide says 1200x627, while its single image spec page and Help Center both say 1200 x 628. Both are 1.91:1 and well inside the size limits. Use 1200 x 628.

Should a square ad be 1080 x 1080 or 1200 x 1200?

Use 1200 x 1200 for a single image ad and 1080 x 1080 for carousel cards, the recommended size for each format. Carousel cards display at 312 x 312, so a 1080 upload is still more than 3 times the width the feed shows.

What are the character limits for LinkedIn ad copy?

On single image and video ads, intro text shows 150 characters before it truncates and accepts 3,000, and headlines show 70 and accept 200. Carousel intro text stops at 255 and card headlines at 45. Text ads take a 25-character headline and a 75-character description.

What is the maximum video file size and length?

500 MB and 30 minutes, with a minimum of 75 KB and 3 seconds. LinkedIn recommends 15 to 30 seconds, and guides that still say 200 MB are out of date.

Do vertical images show on desktop?

No. LinkedIn serves vertical single image ads on mobile only, and its spec page says they don't deliver to desktop. Use 1:1 or 1.91:1 when the ad needs to reach desktop too.

What happens if an ad doesn't meet the specs?

LinkedIn scales oversized images down on its own and truncates text past the shown limit in the feed. A file outside the allowed ratios can't be used, and LinkedIn's video Help page warns that an ad might be rejected for non-standard text, such as more than 4 emojis.

Do thought leader ads have their own specs?

No. A thought leader ad uses the specs of the post it sponsors, so image posts follow the single image specs and video posts the video specs. LinkedIn is gradually letting advertisers add a headline, a button, a link and a Lead Gen Form to the sponsored version.

Thought leader ads, explained

Free and open source MIT licensed. Run it locally, self-host the endpoint, or read every line on GitHub.

$ claude mcp add adwarp -- npx -y adwarp mcp

Read the docs

GitHub