Bulk CSV Upload for Social Planner: Basic and Advance Formats

By Sparkforge Support Team ·Last reviewed May 3, 2026

Sparkforge Social Planner accepts .csv and .xlsx bulk uploads in two formats: Basic (date, content, media, link) and Advance (platform-specific options for every channel). Schedule times must use 24-hour format and run at least 10 minutes ahead.

Social Planner accepts bulk uploads in .csv or .xlsx format. Two upload modes are available depending on how much control you need over each post.

Basic CSV vs. Advance CSV

Basic CSV covers the core fields: date, content, OG meta URL, image link, video link, and GIF link.

Advance CSV unlocks platform-specific post types (post, story, reel, shorts), watermark, tags, categories, follow-up comments, Google Business Profile post types, YouTube metadata, TikTok options, LinkedIn PDFs, Pinterest board selection, and more.

Date and time column (both formats)

Header: postAtSpecificTime

Use 24-hour format. Example: 2025-08-25 21:30.
Empty date cells push the post to Draft.
Schedule at least 10 minutes after the upload time.
Accepted formats: YYYY-MM-DD HH:mm, YYYY-MM-DD HH:mm:ss, YYYY/MM/DD HH:mm:ss, YYYY/MM/DD HH:mm, M/D/YYYY H:mm:ss, M/D/YYYY H:mm.

Content and media columns (both formats)

content — caption text and hashtags. Respect each platform's character limit.
link (OGmetaUrl) — preview URL. Overridden if image, video, or GIF is also set.
imageUrls — comma-separated, max 10. PNG/JPEG.
videoUrls — comma-separated, max 10.
gifUrl — single URL. Do not combine with other media.

Advance CSV-only fields

mediaOptimization (true/false) — auto-converts mismatched formats (for example, MP4 to MOV for Instagram stories).
applyWatermark (true/false) — adds your watermark to media.
tags — comma-separated. New entries appear in filters.
Category — single category per post.
followUpComment — first comment on the post (Facebook Pages, Instagram Business, LinkedIn, YouTube, Sparkforge Communities).
type (post/story/reel) — Facebook and Instagram.
pdfTitle, postAsPdf — LinkedIn PDF posts.
eventType, actionType, title, offerTitle, startDate, endDate, termsConditions, couponCode, redeemOnlineUrl, actionUrl — Google Business Profile.
title, privacyLevel, type — YouTube.
TikTok privacy, comment, duet, stitch, branded content options.
Community title and member-notify flag.
Pinterest title and link (set default board in Social Planner Settings).

Google Business Profile field matrix

Post type	actionType	actionUrl	title	offerTitle	dates	terms	coupon
Call to Action	yes	yes	no	no	no	no	no
Event	yes	yes	yes	no	yes	no	no
Offer	no	no	no	yes	yes	yes	yes

Frequently Asked Questions

What's the difference between Basic and Advance CSV?

Basic CSV covers date, content, link preview, and media. Advance CSV adds platform-specific options like post types, watermarks, tags, follow-up comments, and per-platform metadata for YouTube, TikTok, LinkedIn, Pinterest, and Google Business Profile.

Why do my scheduled posts go to Draft?

An empty date cell pushes the post to Draft. Make sure every row has a valid <code>postAtSpecificTime</code> value in 24-hour format, scheduled at least 10 minutes after upload.

Can I mix images, videos, and GIFs on one post?

No. If <code>gifUrl</code> or <code>videoUrls</code> is set, do not also fill in image or link columns — only one media type per post.

What's the maximum number of images or videos per post?

10 images or 10 videos per post, comma-separated in the <code>imageUrls</code> or <code>videoUrls</code> column.

How far in advance should I upload my CSV?

At least 10 minutes before the earliest scheduled post time. If a post is scheduled for 3:00 PM, upload no later than 2:50 PM.