Bulk Publishing Guide

Learn how to publish multiple stories at once using BlokMCP - saving you hours of manual work in the Storyblok interface.

Overview

Bulk publishing is one of the most powerful features of BlokMCP. Instead of clicking through each story individually in Storyblok, you can publish dozens or hundreds of stories with a single conversation.

What you'll learn:

Publishing all stories in a folder
Publishing by tag or status
Publishing with filters and conditions
Scheduling bulk releases
Handling errors and confirmations
Best practices for large operations

Prerequisites

BlokMCP connected to your MCP client
Management token with publish permissions
Stories ready to publish in your Storyblok space

Basic Bulk Publishing

Publish All Stories in a Folder

The most common bulk publishing scenario is publishing everything in a specific folder.

Publish all stories in the "blog/ready-for-launch" folder

Claude will:

Fetch all stories in that folder
Publish each one
Report success or errors

Example response:

I've published 12 stories from the "blog/ready-for-launch" folder:

✓ "Summer Collection Announcement" (ID: 123456)
✓ "Behind the Scenes: Our Design Process" (ID: 123457)
✓ "Customer Success Story: ACME Corp" (ID: 123458)
...

All 12 stories are now live!

Publish by Tag

Publish all stories with a specific tag:

Publish all stories tagged with "approved"

Publish by Multiple Criteria

Combine multiple filters for precise control:

Publish all stories in the "news" folder that:
- Are tagged with "reviewed"
- Were updated in the last 7 days
- Are currently unpublished

Advanced Bulk Publishing

With Date Filtering

Publish all blog posts created in December 2024 that are still in draft

Exclude Specific Stories

Publish all stories in the "products" folder except those
containing "discontinued" in the title

Conditional Publishing

Find all stories in the "announcements" folder.
If there are fewer than 10, publish them all.
If there are more than 10, show me the list first for review.

Scheduled Bulk Publishing

Schedule for Specific Date/Time

Schedule all stories in the "spring-collection" folder to
publish on March 1st, 2024 at 9:00 AM EST

Staggered Publishing

Publish stories from the "blog/weekly" folder one per day
starting tomorrow at 10:00 AM

Claude will create a schedule and confirm the publishing times for each story.

Safety & Confirmations

Always Preview First

For large operations, it's smart to review what will be published:

Show me all stories in the "news/2024" folder that are
currently unpublished. If the list looks good, I'll ask you to publish them.

Then after reviewing:

Yes, publish all of those stories

Request Confirmation for Large Sets

Find all stories tagged "launch-ready". If there are more than
20, ask me to confirm before publishing.

Test with Small Batches First

For first-time bulk operations:

Publish the first 3 stories in the "blog/approved" folder
so I can verify everything works correctly

Then scale up:

Publish the remaining stories in the "blog/approved" folder

Handling Errors

What Happens if Publishing Fails?

Claude will report which stories succeeded and which failed:

I've published 47 out of 50 stories. Three failed:

✗ "Product XYZ" (ID: 123) - Missing required field 'price'
✗ "About Team" (ID: 124) - Workflow approval required
✗ "Contact" (ID: 125) - Insufficient permissions

Would you like me to help fix these issues?

Common Publishing Errors

Error	Cause	Solution
Missing required field	Content incomplete	Update story with missing data
Workflow approval required	Story in approval workflow	Complete approval process first
Insufficient permissions	Token lacks publish permission	Update token permissions in Storyblok
Already published	Story already live	Use `update` instead of `publish`

Retry Failed Stories

Try publishing those 3 failed stories again after I fix them

Common Scenarios

Scenario 1: Weekly Blog Launch

Goal: Publish all completed blog posts for the week.

Publish all stories in the "blog/week-of-jan-15" folder
that are tagged "ready"

Scenario 2: Product Catalog Update

Goal: Publish all new products that have been reviewed.

In the "products" folder, find all stories that:
1. Are unpublished
2. Have the tag "reviewed"
3. Have all required fields filled (name, price, description, image)

Publish them if there are fewer than 100, otherwise ask for confirmation.

Scenario 3: Seasonal Content Rollout

Goal: Publish holiday content at the start of the season.

Schedule all stories in the "seasonal/christmas-2024" folder
to publish on November 1st, 2024 at 12:00 AM

Scenario 4: Archive and Replace

Goal: Unpublish old content and publish new versions.

1. Unpublish all stories in the "news/2023" folder
2. Publish all stories in the "news/2024" folder

Scenario 5: Multilingual Launch

Goal: Publish all language versions of content simultaneously.

For all stories in the "products" folder, publish both the
English and Spanish versions

Performance Considerations

Rate Limits

Be aware of your subscription tier's rate limits:

Tier	Requests/Minute
Free	10
Pro	100
Enterprise	1,000

For large bulk operations (100+ stories), Claude will automatically pace the requests to stay within your limits.

Processing Time

Rough estimates:

10 stories: ~10-30 seconds
50 stories: ~1-3 minutes
100 stories: ~2-5 minutes
500+ stories: ~10-30 minutes (with rate limiting)

Optimize Performance

Publish 100 stories at a time from the "archive" folder,
pausing between batches to avoid rate limits

Reverting Bulk Publishing

Unpublish in Bulk

If you need to take down content:

Unpublish all stories in the "promotions" folder

Selective Unpublishing

Unpublish all stories published in the last 24 hours that
are tagged "temporary"

Best Practices

1. Start Small, Scale Up

Always test with a few stories before bulk operations:

Publish the first 5 stories in the "blog" folder.
If successful, publish the rest.

2. Use Folders for Organization

Organize stories into folders by status:

drafts/ - Work in progress
ready-for-review/ - Complete but not approved
approved/ - Ready to publish
published/ - Currently live

Then publishing is simple:

Publish all stories in the "approved" folder

3. Leverage Tags

Tag stories at different stages:

draft - Initial creation
reviewed - Passed content review
approved - Ready for publishing

4. Check Before Publishing

For important content launches:

Before publishing, show me:
1. Count of stories to be published
2. List of story titles
3. Any missing required fields
4. Current publication dates

5. Document Your Process

Create a checklist for regular bulk publishes:

Content team moves stories to "approved" folder
Run quality check
Publish batch
Verify in Storyblok
Notify team

6. Use Scheduling for Time-Sensitive Content

For coordinated launches:

Schedule all product launch content to publish exactly at
10:00 AM on launch day

Monitoring Results

Verify Publishing Success

After bulk publishing:

Show me all stories in the "blog" folder and their
publication status. Count how many are published vs draft.

Check Recent Publications

Show me all stories that were published in the last hour

Get Publishing Report

For all stories published today, show me:
- Story title
- Folder
- Publication time
- Who last modified it

Troubleshooting

"Some Stories Failed to Publish"

Check for:

Missing required fields
Workflow approvals needed
Permission issues
Content validation errors

Ask Claude to diagnose:

For the stories that failed to publish, analyze what's
wrong with each one

"Rate Limit Exceeded"

If you hit rate limits:

I'll pause for 60 seconds and continue publishing the
remaining stories

Or upgrade your plan for higher limits.

"Stories Not Found"

Verify folder paths and filters:

List all folders in my space so I can see the correct path

Scheduled Releases - Coordinated multi-story releases
Content Translation - Publishing multilingual content
Workflow Automation - Automated approval and publishing

Quick Reference

Common Commands

# Publish all in folder
"Publish all stories in the 'blog/ready' folder"

# Publish by tag
"Publish all stories tagged 'approved'"

# Publish with conditions
"Publish unpublished stories in 'news' updated in the last week"

# Schedule publish
"Schedule all stories in 'launch' to publish on March 1st at 9 AM"

# Unpublish bulk
"Unpublish all stories in the 'promotions' folder"

# Check status
"Show me publication status of all stories in 'products'"

Need help with bulk publishing? Ask Claude to guide you through the process or check out our conversation starters for more examples!