How to bulk upload posts with a CSV file in Postoria

Bulk upload lets you create many posts at once from a CSV file instead of building them one by one.

In Postoria, posts from a CSV file are first created as draft posts. After that, you can review them, edit them, schedule them, or publish them right away.

Before you start

Here are the main things to know before you upload your CSV:

  • Bulk upload is not available on the Free plan
  • Only CSV files are supported
  • You can download a ready-to-use CSV template here: bulk-upload-template.csv
  • Your CSV file must be 10 MB or smaller
  • A single CSV file can contain up to 100 rows
  • Media, link, and thumbnail URL values must use full http:// or https:// URLs
  • Thumbnail fields can also use a whole-number timestamp in milliseconds
  • If you want to schedule a post, Date and Time must both be filled in
  • Scheduled date and time are interpreted using your workspace time zone
  • Social network-specific validation rules still apply after import

Supported CSV columns

Postoria supports these column names:

  • Date
  • Time
  • Content Type
  • Media 1
  • Media 1 Thumbnail
  • Media 2
  • Media 2 Thumbnail
  • Media 3
  • Media 3 Thumbnail
  • Media 4
  • Media 4 Thumbnail
  • Media 5
  • Media 5 Thumbnail
  • Media 6
  • Media 6 Thumbnail
  • Media 7
  • Media 7 Thumbnail
  • Media 8
  • Media 8 Thumbnail
  • Media 9
  • Media 9 Thumbnail
  • Media 10
  • Media 10 Thumbnail
  • Caption
  • Link URL
  • First Comment
  • Comment Delay
  • Repost Frequency
  • Repost Until Date
  • Repost Until Time
  • YouTube Title
  • YouTube Visibility
  • YouTube Category
  • YouTube Made For Kids
  • YouTube Video Language
  • YouTube Recording Date
  • YouTube Tags
  • TikTok Who Can Watch
  • TikTok Photo Title
  • TikTok Allow Comments
  • TikTok Allow Duet
  • TikTok Allow Stitch
  • TikTok Auto Add Music
  • TikTok Disclose Post Content
  • TikTok Your Brand
  • TikTok Branded Content

Use the column names exactly as shown above.

Column order does not matter. Postoria matches fields by column name, not by position.

All CSV columns are optional.

You do not have to include every optional column in every CSV. For example, if you only need one media field, you can use Media 1 and leave out the rest.

However, some fields still have validation rules when they are used. For example, if you provide Date, you must also provide Time, and vice versa.

Even if a CSV row is imported successfully, social network validation rules still apply when draft posts are created or later published.

Supported content types

Postoria supports these content types in bulk upload:

  • Image
  • Video
  • Story
  • Carousel
  • Link
  • Text
  • Reel

If you leave Content Type empty, Postoria will try to determine it automatically based on the CSV row data:

  • Multiple media URLs → Carousel
  • One media URL → Image or Video
  • A link without media → Link
  • Caption only → Text

If Postoria cannot determine the content type, the CSV row cannot be imported.

CSV formatting rules

A few formatting rules are important:

Date format

Use this format:

yyyy-MM-dd

Examples:

2026-12-31
2027-01-01

Time format

Use 24-hour time:

HH:mm

Examples:

08:05
23:59

URLs must be absolute

For Media fields, Link URL, and thumbnail image URLs, use full URLs such as:

https://example.com/image.png

Relative paths, broken links, and non-web file paths are not supported.

Media thumbnail values

Use Media 1 Thumbnail, Media 2 Thumbnail, and other matching thumbnail columns to set thumbnails for media files.

Each thumbnail column applies only to the matching media column:

  • Media 1 Thumbnail sets a thumbnail for Media 1
  • Media 2 Thumbnail sets a thumbnail for Media 2
  • Media 3 Thumbnail sets a thumbnail for Media 3

A media thumbnail value can be either:

  • a full image URL, or
  • a timestamp in milliseconds

Use a full image URL when you want to provide your own thumbnail image.

Example:

https://example.com/thumbnail.jpg

Use a timestamp in milliseconds when you want Postoria to generate the thumbnail from the matching video file.

Examples:

0
1000
3000

Rules:

  • Thumbnail URL values must use full http:// or https:// URLs
  • Timestamp values must be whole numbers in milliseconds
  • Do not include ms after the number
  • Social network-specific thumbnail rules may still apply when the post is created or published

Multiline caption and first comment are supported

Caption can contain multiple lines. This is useful for longer captions, paragraphs, and hashtags.

First Comment can also contain multiple lines.

Comment Delay values

Use Comment Delay to control when the comment from the First Comment column is published.

Enter the delay in minutes.

Examples:

0
2
15

Rules:

  • Leave Comment Delay empty to use the workspace default when the draft post is created
  • Use 0 to publish the comment with the post
  • Use a whole number from 1 to 120 to publish the comment after that many minutes

Repost column values

Use these values for repost settings:

  • Repost Frequency: Do not repost, Day, 2 days, 3 days, 4 days, 5 days, 6 days, 7 days, 8 days, 9 days, 10 days, 11 days, 12 days, 13 days, 14 days, 15 days, 16 days, 17 days, 18 days, 19 days, 20 days, 21 days, 22 days, 23 days, 24 days, 25 days, 26 days, 27 days, 28 days, 29 days, 30 days, 31 days, 32 days, 33 days, 34 days, 35 days, 36 days, 37 days, 38 days, 39 days, 40 days, 41 days, 42 days, 43 days, 44 days, 45 days, 46 days, 47 days, 48 days, 49 days, 50 days, 51 days, 52 days, 53 days, 54 days, 55 days, 56 days, 57 days, 58 days, 59 days, 60 days, Month, 2 months, 3 months, 4 months, 6 months, or Year
  • Repost Until Date: use yyyy-MM-dd
  • Repost Until Time: use HH:mm

If you provide Repost Until Date, you must also provide Repost Until Time, and vice versa.

YouTube column values

Use these values for YouTube-specific columns:

  • YouTube Title: enter plain text
  • YouTube Visibility: Private, Unlisted, or Public
  • YouTube Category: Autos & Vehicles, Comedy, Education, Entertainment, Film & Animation, Gaming, Howto & Style, Music, News & Politics, Nonprofits & Activism, People & Blogs, Pets & Animals, Science & Technology, Sports, or Travel & Events
  • YouTube Made For Kids: true or false
  • YouTube Video Language: use a supported YouTube language code
  • YouTube Recording Date: use yyyy-MM-dd
  • YouTube Tags: enter one or more tags separated by commas

Supported YouTube Video Language values:

  • af = Afrikaans
  • sq = Albanian
  • am = Amharic
  • ar = Arabic
  • hy = Armenian
  • as = Assamese
  • az = Azerbaijani
  • bn = Bangla
  • eu = Basque
  • be = Belarusian
  • bs = Bosnian
  • bg = Bulgarian
  • my = Burmese
  • ca = Catalan
  • zh-CN = Chinese (China)
  • zh-HK = Chinese (Hong Kong)
  • zh-TW = Chinese (Taiwan)
  • hr = Croatian
  • cs = Czech
  • da = Danish
  • nl = Dutch
  • en = English
  • en-IN = English (India)
  • en-GB = English (United Kingdom)
  • et = Estonian
  • fil = Filipino
  • fi = Finnish
  • fr = French
  • fr-CA = French (Canada)
  • gl = Galician
  • ka = Georgian
  • de = German
  • el = Greek
  • gu = Gujarati
  • iw = Hebrew
  • hi = Hindi
  • hu = Hungarian
  • is = Icelandic
  • id = Indonesian
  • it = Italian
  • ja = Japanese
  • kn = Kannada
  • kk = Kazakh
  • km = Khmer
  • ko = Korean
  • ky = Kyrgyz
  • lo = Lao
  • lv = Latvian
  • lt = Lithuanian
  • mk = Macedonian
  • ms = Malay
  • ml = Malayalam
  • mr = Marathi
  • mn = Mongolian
  • ne = Nepali
  • no = Norwegian
  • or = Odia
  • fa = Persian
  • pl = Polish
  • pt = Portuguese
  • pt-PT = Portuguese (Portugal)
  • pa = Punjabi
  • ro = Romanian
  • ru = Russian
  • sr = Serbian
  • sr-Latn = Serbian (Latin)
  • si = Sinhala
  • sk = Slovak
  • sl = Slovenian
  • es = Spanish
  • es-419 = Spanish (Latin America)
  • es-US = Spanish (United States)
  • sw = Swahili
  • sv = Swedish
  • ta = Tamil
  • te = Telugu
  • th = Thai
  • tr = Turkish
  • uk = Ukrainian
  • ur = Urdu
  • uz = Uzbek
  • vi = Vietnamese
  • zu = Zulu

TikTok column values

Use these values for TikTok-specific columns:

  • TikTok Who Can Watch: Public, Followers, Friends, or Private
  • TikTok Allow Comments: true or false
  • TikTok Allow Duet: true or false
  • TikTok Allow Stitch: true or false
  • TikTok Disclose Post Content: true or false
  • TikTok Your Brand: true or false
  • TikTok Branded Content: true or false
  • TikTok Photo Title: enter plain text up to 90 characters
  • TikTok Auto Add Music: true or false

How to bulk upload posts in Postoria

  1. Open the Posts page and click Bulk upload
  2. Select the target accounts you want to use
    You can also apply a group if you already have one set up
  3. Click Proceed
  4. Upload your CSV file
  5. Click Proceed again to let Postoria read the file
  6. Review the imported rows and make sure the file was read correctly
  7. Click Create draft posts to turn imported rows into drafts
  8. Review the created drafts and either:
    • schedule them, or
    • publish them right away

That’s it. Bulk upload creates draft posts first so you can still review everything before publishing.

What happens after upload

After your CSV is read:

  • Imported rows appear on the bulk upload page for review
  • You can confirm that the file was read correctly before creating drafts
  • You can schedule all draft posts at once
  • You can also publish all draft posts right away from the bulk actions menu

If some draft posts cannot be created later, those CSV rows stay on the page with an error message.

Common questions

Can I upload an Excel file?

No. Bulk upload currently supports CSV files only.

Can I use only some of the supported columns?

Yes. You only need the columns relevant to your posts. For example, a CSV row with only Media 1 can still work.

Does column order matter?

No. Postoria matches CSV columns by name, not by position.

For thumbnails, the number in the column name matters. For example, Media 1 Thumbnail always applies to Media 1, even if the columns are not next to each other.

Can I leave Content Type empty?

Yes. Postoria will try to detect it automatically from the CSV row data.

Can I leave Date and Time empty?

Yes, but only if both are empty.
If one is filled in, the other must also be filled in.

Does bulk upload publish posts immediately?

No. Bulk upload creates draft posts first. You can then review, schedule, or publish them.

Can I add thumbnails from a CSV file?

Yes. Use Media 1 Thumbnail, Media 2 Thumbnail, and other matching thumbnail columns.

You can enter either a full image URL or a timestamp in milliseconds.

For example, use Media 1 Thumbnail to set a thumbnail for Media 1.

Can I use one thumbnail column for all media files?

No. Thumbnails are matched by media number.

Use Media 1 Thumbnail for Media 1, Media 2 Thumbnail for Media 2, and so on.

Can I use a timestamp for a thumbnail?

Yes. Enter a whole number in milliseconds.

For example:

1000

This means Postoria will generate the thumbnail from the matching video file at 1 second.

Do not include ms after the number.

Can I delay the comment added from the First Comment column?

Yes. Add the Comment Delay column and enter the delay in minutes, or leave the field empty to use the workspace default for new posts.

Final note

Bulk upload is the fastest way to create many posts at once in Postoria, but it works best when your CSV follows the exact column names and formatting rules.

If a CSV row cannot be imported or a draft cannot be created later, Postoria will show you where the problem is so you can fix it.