Docs Home

Bulk Post

Learn more about bulk post in our help documentation.

Bulk Post — CSV-Only (Fastest Way to Scale)

Launch campaigns, seasonal promos, and evergreen content in minutes—not weeks. Upload a CSV, and let Postly validate and publish across all your channels.

Quick Start (CSV Only)

  1. Grab the CSV template
    Dashboard → Posts → Bulk Post → Download CSV Template.

    Tip: Use Postly Cloud to host media and generate clean, public Image URL / Video URL links.

  2. Add your content
    Paste copy and media URLs into the template. Keep the header row intact.

  3. Upload CSV
    Drop the file on the Bulk Post page for a one-time batch.

  4. Validate & Preview
    The UI shows live previews and highlights errors by row/column.

  5. Schedule & Publish
    Confirm to schedule. Track Scheduled / Published / Failed in your dashboard.

Method: CSV Upload (Classic & Fast)

  • Best for: quick one-time batches up to 500 rows (min 4).
  • Validation: preview + error highlights before scheduling.
  • Edits: re-upload an updated CSV to change anything.
  • Media: paste public URLs; Postly Cloud recommended for speed & reliability.
  • Template: keep official headers and order.

CSV Template

Core headers

  • text — your post caption / copy
  • platforms — comma- or space-separated (e.g., 
    facebook
    , 
    instagram
    , 
    linkedin
    , 
    twitter
    )
  • due_date — when to publish (see accepted formats below)
  • image_url — direct, public file URL (optional)
  • video_url — direct, public file URL or standard YouTube/Vimeo link (optional)

Platform-specific columns (e.g., first-comment, story/reel toggles) are documented in-app on the Bulk Post page with examples.

Time format (
due_date
)

Safest formats (recommended):

2025-10-17T14:30:00Z
2025-10-17T14:30:00
2025-10-17 14:30:00
2025-10-17 14:30
2025/10/17 14:30
2025-10-17

Also accepted (regional/flexible):

10/17/2025 14:30
10/17/2025
17/10/2025 14:30
17-10-2025 14:30
Oct 18, 2025 14:30
2025/10/19 22:00

Times default to UTC unless your workspace timezone is set.

Media URLs (What Works vs. What Doesn’t)

✅ Works

  • Direct files from a public CDN (
    .jpg
    , 
    .png
    , 
    .gif
    , 
    .webp
    , 
    .mp4
    , 
    .mov
    )
  • Standard YouTube/Vimeo links (single video pages)
  • Postly Cloud public URLs (recommended)

Examples:

https://cloud.postly.ai/media/your-image.jpg
https://cloud.postly.ai/media/your-video.mp4
https://www.youtube.com/watch?v=VIDEO_ID
https://vimeo.com/76979871

❌ Won’t work (and why)

  • YouTube Shorts (
    /shorts/…
    ) or playlist/channel pages — not single video files
  • Google Drive/Photos, Dropbox, iCloud share pages — require auth / not direct files
  • Expiring signed URLs — may break before publish time
  • Data URIs (
    data:image/png;base64,…
    ) — unsupported in bulk

Copy-Paste CSV Examples

✅ Works

textplatformsdue_dateimage_urlvideo_url
YouTube (standard)facebook2025-10-24T09:00
https://www.youtube.com/watch?v=dQw4w9WgXcQ
Direct MP4 (CDN)linkedin2025-10-25 11
https://download.blender.org/peach/bigbuckbunny_movies/BigBuckBunny_320x180.mp4
Postly Cloud imageinstagramOct 26, 2025 14
https://cloud.postly.ai/media/your-image.jpg
Wikimedia direct JPGtwitter2025/10/27 22
https://upload.wikimedia.org/wikipedia/commons/9/9a/Gull_portrait_ca_usa.jpg

❌ Common Pitfalls

textplatformsdue_dateimage_urlvideo_urlreason
YouTube Shorts pagefacebook2025-10-24T09:00
https://youtube.com/shorts/XXXXXXXXXXXPage link, not a standard video URL
Google Photos sharelinkedin2025-10-25 11
https://photos.google.com/share/XXXXRequires auth / not a direct file
Instagram post pageinstagramOct 26, 2025 14
https://www.instagram.com/p/XXXXXXXXX/HTML page, not a direct image
Dropbox preview linktwitter2025/10/27 22
https://www.dropbox.com/s/FILE/photo.png?dl=0Preview page, not a direct file

Scheduling & Limits

  • Rows per CSV: 4 – 500
  • Per-row targeting: choose platforms per row via 
    platforms
    column
  • Media URLs: must be publicly accessible direct files (or standard YouTube/Vimeo)
  • Workspaces & accounts: connect only the accounts you intend to publish to

Tips

  • Use the official CSV template; don’t rename headers or change their order.
  • Keep media links public; private or gated links won’t render.
  • Organize clients/brands with Workspaces to keep content and connections clean.
  • Prefer Postly Cloud for reliable, non-expiring URLs.

Troubleshooting

  • Validation error? The UI pinpoints the exact row/column—fix and re-upload.
  • No media preview? Ensure the URL is public and points to the file itself.
  • Timezone confusion? Use ISO format (e.g., 
    2025-10-17T14:30:00Z
    ) or set the workspace timezone.

FAQ (CSV)

Can I mix platforms in one CSV?
Yes. Put multiple platforms in the 

platforms
column; options are defined in the template.

Can I choose which accounts to post to?
Yes—connect only the accounts you want in each Workspace. The app will guide selection/targeting at schedule time.

What happens after upload?
You’ll see previews, validation results, and final statuses: Scheduled / Published / Failed.

Where do I find the template?
Dashboard → Posts → Bulk Post.

Move fast: Open your dashboard and start your first CSV batch now → https://app.postly.ai