SFEED.DEV
Docs FAQ Privacy Terms

Posting

Basic post

sfeed post "Just shipped a new feature"

If you have one connected Page, sfeed posts to the platforms supported by that Page. If you have multiple connected Pages, add --page to choose one first.

Target specific platforms

sfeed post "Just shipped a new feature" --to facebook
sfeed post "Just shipped a new feature" --to instagram
sfeed post "Just shipped a new feature" --to facebook,instagram

Post from a specific page

sfeed post "Release note" --page "Acme Robotics"

If you have multiple connected Pages, use --page with a page name or page ID. sfeed does not keep a default posting Page anymore.

Attach media

sfeed post "New dashboard" --to facebook --media ./screenshot.jpg
sfeed post "New dashboard" --to instagram --media ./screenshot.jpg
sfeed post "Launch clip" --to facebook --kind reel --media ./demo.mp4
sfeed post "Story update" --to instagram --kind story --media ./story.jpg

--media accepts local files or public URLs. sfeed stages local files automatically when Instagram or hosted scheduling needs a public URL.

Supported post shapes are simple on purpose. Facebook supports feed posts, single image, multi-image, single video, Page Reels, and Page Stories. Instagram supports feed media, Reels, Stories, and image-only carousels. Instagram does not support text-only posts.

Use --kind feed, --kind reel, --kind story, or --kind carousel when the media shape alone is not clear.

Schedule a post

sfeed post "Monday motivation" --at "2026-04-01T09:00:00Z"
sfeed post "Tomorrow's clip" --to instagram --media ./clip.mp4 --at "2026-04-01T09:00:00Z"

Hosted scheduling checks for due posts every minute.

Hosted scheduling requires a subscription. If you schedule local media, sfeed hosts it temporarily for the scheduled job.

Scheduled posts that rely on local files must be within 90 days. Local staged files must be 100 MB or smaller.

Dry run

sfeed post "test" --dry-run

Shows what would be posted without actually posting.

Options

Back to Docs