Skip to main content

​
Bulk Publish

Bulk publish lets you send multiple campaigns to advertising platforms simultaneously. Instead of publishing campaigns one by one, you publish entire campaign groups or your entire canvas at once. This is essential for managing campaigns at scale and ensures consistent deployment across multiple campaigns.
What you’ll learn:
  • How to publish multiple campaigns at once
  • Validation behavior during bulk operations
  • How to handle partial failures when some campaigns succeed and others fail
  • Best practices for efficient bulk publishing

​
How Bulk Publish Works

When you click Publish with multiple campaigns on the canvas, Whathead processes all campaigns in parallel. Each campaign goes through validation, preview, and execution independently, but you manage them all from one interface.

​
Basic Bulk Publish Workflow

1

Prepare campaigns

Build or import multiple campaigns on the canvas. Ensure all campaigns are configured and ready to publish.
2

Validate all campaigns

Whathead validates all campaigns simultaneously. Campaigns with errors are flagged and must be fixed before publishing.
3

Review preview

See what will happen for each entity across all campaigns: which will CREATE, UPDATE, or SKIP.
4

Confirm and publish

Click Publish to send all campaigns to platforms. Whathead processes campaigns in parallel for speed.
5

Monitor progress

Watch real-time progress indicators showing which campaigns are processing, succeeded, or failed.
6

Handle results

Review success and failure status for each campaign. Retry failed campaigns after fixing errors.
Bulk publish is much faster than publishing campaigns individually. Whathead processes campaigns in parallel, so 10 campaigns take roughly the same time as 1 campaign.

​
Validation During Bulk Publish

Before bulk publishing, Whathead validates all campaigns simultaneously.

​
Validation Scope

Whathead checks:
  • All campaigns: Every campaign node on the canvas
  • All ad sets: Every ad set under each campaign
  • All ads: Every ad under each ad set
  • Cross-campaign constraints: Rules that apply across multiple campaigns

​
Validation Results

After validation, you see:
  • Valid campaigns: Green checkmarks indicate campaigns ready to publish
  • Invalid campaigns: Red warning icons indicate campaigns with errors
  • Error summary: Total count of errors across all campaigns
  • Error details: Specific errors for each invalid campaign
You cannot publish any campaigns if validation fails. Fix all errors across all campaigns before proceeding. One invalid campaign blocks the entire bulk publish operation.

​
Fixing Validation Errors

When validation fails:
  1. Review error summary: See which campaigns have errors
  2. Click invalid campaigns: Open nodes with red warning icons to see error details
  3. Fix errors: Update configurations to resolve validation issues
  4. Re-validate: Whathead automatically re-validates as you fix errors
  5. Publish when all valid: Once all campaigns show green checkmarks, you can publish
Use the error summary panel to see all validation errors at once. This helps you prioritize fixes and understand the scope of issues.

​
Preview for Bulk Publish

After validation passes, you see a preview showing what will happen for all campaigns.

​
Preview Structure

The preview is organized by campaign: 
Campaign: "Summer Sale 2024" → UPDATE
  ├─ Ad Set: "US Audience 18-35" → SKIP (no changes)
  │   ├─ Ad: "Beach Photo A" → UPDATE
  │   └─ Ad: "Beach Photo B" → CREATE
  └─ Ad Set: "UK Audience 25-45" → CREATE
      └─ Ad: "City Photo A" → CREATE

Campaign: "Fall Sale 2024" → CREATE
  └─ Ad Set: "US All Ages" → CREATE
      └─ Ad: "Video Promo A" → CREATE

Campaign: "Winter Sale 2024" → SKIP (no changes)
  └─ Ad Set: "Global Audience" → SKIP (no changes)
      └─ Ad: "Snow Photo A" → SKIP (no changes)

​
Preview Summary

At the top of the preview, you see totals:
  • Total entities: How many campaigns, ad sets, and ads will be processed
  • CREATE count: How many new entities will be created
  • UPDATE count: How many existing entities will be updated
  • SKIP count: How many entities will be skipped (no changes)
Review the preview carefully before confirming. Make sure CREATE, UPDATE, and SKIP actions match your expectations across all campaigns.

​
Filtering Preview

You can filter the preview to show:
  • Only campaigns with changes: Hide campaigns that will be skipped
  • Only CREATE actions: See what new entities will be created
  • Only UPDATE actions: See what existing entities will be updated
  • Specific platforms: Show only Meta campaigns, only TikTok campaigns, etc.

​
Publishing Execution

After you confirm, Whathead executes API calls to create or update entities across all campaigns.

​
Parallel Processing

Whathead publishes campaigns in parallel:
  • Multiple campaigns at once: Up to 10 campaigns process simultaneously
  • Hierarchical order within campaigns: Each campaign publishes in order (campaign → ad sets → ads)
  • Platform independence: Campaigns for different platforms process independently
This parallel processing dramatically speeds up bulk publishing compared to sequential publishing.

​
Progress Indicators

During bulk publishing, you see: Campaign-level progress:
  • Processing: Campaign is currently being published
  • Success: Campaign published successfully
  • Failed: Campaign encountered an error
  • Pending: Campaign is waiting to be processed
Entity-level progress:
  • Total entities processed
  • Entities succeeded
  • Entities failed
  • Entities skipped
Overall progress:
  • Percentage complete (e.g., “45% complete”)
  • Estimated time remaining
  • Current operation (e.g., “Publishing ad sets for Summer Sale 2024”)
You can minimize the progress panel and continue working in Whathead while bulk publishing runs in the background. You’ll be notified when publishing completes.

​
Handling Partial Failures

When publishing multiple campaigns, some may succeed while others fail. Whathead handles partial failures gracefully.

​
Partial Failure Scenarios

Scenario 1: Some campaigns succeed, others fail
  • Successful campaigns are live on platforms
  • Failed campaigns remain on canvas with error messages
  • You can retry failed campaigns without affecting successful ones
Scenario 2: Campaign succeeds, but some ad sets fail
  • Campaign is created on platform
  • Successful ad sets are created
  • Failed ad sets remain on canvas with error messages
  • You can retry failed ad sets under the existing campaign
Scenario 3: Campaign and ad sets succeed, but some ads fail
  • Campaign and ad sets are created on platform
  • Successful ads are created
  • Failed ads remain on canvas with error messages
  • You can retry failed ads under existing ad sets
Partial failures don’t roll back successful entities. If a campaign succeeds but an ad set fails, the campaign remains live on the platform. Fix the ad set error and retry publishing.

​
Retry Workflow

To retry failed entities after partial failure:
1

Review failure details

Click failed campaigns to see specific error messages explaining what went wrong.
2

Fix the issues

Update configurations to resolve errors. This might involve changing budgets, updating creative, or reconnecting platforms.
3

Retry publishing

Click Publish again. Whathead automatically detects which entities failed and only retries those. Successful entities are skipped.
4

Monitor retry progress

Watch progress indicators to see if retries succeed. Repeat until all campaigns are published successfully.
If a parent entity fails (e.g., campaign), its children (ad sets and ads) are not published. Fix the parent error first, then retry publishing to create the children.

​
Common Bulk Publish Errors

Error: “Meta authentication failed. Please reconnect your account.”Cause: Your Meta platform connection expired, but other platforms are still connected.Resolution:
  • Campaigns for other platforms (TikTok, Snapchat, Google) will succeed
  • Meta campaigns will fail
  • Reconnect Meta in Settings > Integrations
  • Retry publishing for Meta campaigns
Error: “Too many requests to TikTok API. Please wait and try again.”Cause: You exceeded TikTok’s API rate limit by publishing too many campaigns at once.Resolution:
  • Campaigns published before the rate limit will succeed
  • Campaigns after the rate limit will fail
  • Wait 5-10 minutes for the rate limit to reset
  • Retry publishing for failed campaigns
Error: “Account balance is insufficient for this campaign budget.”Cause: Your ad account doesn’t have enough funds for all campaigns.Resolution:
  • Campaigns with lower budgets may succeed
  • Campaigns with higher budgets may fail
  • Add funds to your ad account
  • Retry publishing for failed campaigns
Error: “Ad creative violates platform policies.”Cause: Some ads have creative that doesn’t comply with platform policies.Resolution:
  • Campaigns with compliant creative will succeed
  • Campaigns with non-compliant creative will fail
  • Update creative for failed ads
  • Retry publishing for failed campaigns
Error: “Request timed out. Please check your connection and try again.”Cause: Network connection was lost during publishing.Resolution:
  • Some campaigns may have succeeded before the timeout
  • Check platform portals to see which campaigns are live
  • Retry publishing for campaigns that didn’t succeed

​
Bulk Publish Best Practices

Validate before publishing: Fix all validation errors before clicking Publish. This prevents wasted time waiting for bulk publish to fail.
Start with a small batch: When bulk publishing for the first time, start with 5-10 campaigns to verify everything works correctly. Then scale up to larger batches.
Group by platform: Publish campaigns for one platform at a time if you’re unsure about platform connections. This isolates failures to one platform.
Monitor progress: Watch the progress indicators during bulk publishing. If you see failures, you can cancel the operation and fix issues before more campaigns fail.
Use retry efficiently: After partial failures, fix all errors at once before retrying. This is faster than fixing and retrying one campaign at a time.
Check platform portals: After bulk publishing, verify campaigns appear correctly in platform portals. This confirms successful publishing.

​
Bulk Publish Performance

​
Speed Factors

Bulk publish speed depends on:
  • Number of campaigns: More campaigns take longer, but parallel processing minimizes the difference
  • Campaign complexity: Campaigns with many ad sets and ads take longer than simple campaigns
  • Platform API speed: Some platforms respond faster than others
  • Network connection: Faster internet connections improve publishing speed

​
Typical Performance

  • 10 campaigns: 30-60 seconds
  • 50 campaigns: 2-4 minutes
  • 100 campaigns: 5-10 minutes
  • 500 campaigns: 20-30 minutes
These are estimates. Actual performance varies based on campaign complexity, platform API speed, and network conditions.

​
Optimizing Performance

To improve bulk publish speed:
  • Publish during off-peak hours: Platform APIs are faster when fewer users are active
  • Use wired internet: Wired connections are more stable than Wi-Fi
  • Reduce campaign complexity: Simpler campaigns publish faster
  • Batch large publishes: Split very large publishes (500+ campaigns) into multiple batches

​
Canceling Bulk Publish

You can cancel bulk publishing mid-process if needed.

​
How to Cancel

Click the Cancel button in the progress panel. Whathead stops processing new campaigns but completes any campaigns currently in progress.

​
What Happens When You Cancel

  • Completed campaigns: Remain live on platforms (not rolled back)
  • In-progress campaigns: Complete their current operation (campaign, ad set, or ad)
  • Pending campaigns: Are not published
  • Canvas state: Successful campaigns show platform IDs; pending campaigns remain unchanged
Canceling bulk publish does not undo campaigns that were already published. Those campaigns remain live on platforms. Use platform portals to pause or delete them if needed.

​
When to Cancel

Cancel bulk publishing if:
  • You notice validation errors you missed
  • You see many campaigns failing with the same error
  • You realize you need to make changes before publishing
  • Platform APIs are experiencing issues
If you cancel bulk publishing, fix any issues and retry. Whathead will skip campaigns that already succeeded and only publish pending campaigns.

​
Bulk Publish Scenarios

Scenario: You have 50 campaigns ready for a product launch and need to publish them all at once.Steps:
  1. Validate all 50 campaigns (fix any errors)
  2. Review the preview to confirm CREATE actions
  3. Click Publish and monitor progress
  4. Verify all campaigns succeeded
  5. Check platform portals to confirm campaigns are live
All 50 campaigns go live simultaneously, ensuring consistent launch timing.
Scenario: You need to increase budgets for 100 existing campaigns.Steps:
  1. Load all 100 campaigns onto the canvas using Select Existing
  2. Bulk edit all campaigns to update budgets
  3. Click Publish and review preview (all should show UPDATE)
  4. Confirm and monitor progress
  5. Verify all campaigns updated successfully
All 100 campaigns update with new budgets in minutes instead of hours.
Scenario: You have campaigns for Meta, TikTok, Snapchat, and Google on the same canvas.Steps:
  1. Validate all campaigns across all platforms
  2. Review preview to see platform-specific actions
  3. Click Publish to send campaigns to all platforms
  4. Monitor progress for each platform independently
  5. Handle any platform-specific failures
All platforms receive campaigns simultaneously, even if one platform fails.
Scenario: You published 30 campaigns, but 5 failed due to authentication errors.Steps:
  1. Review failure details for the 5 failed campaigns
  2. Reconnect the platform in Settings > Integrations
  3. Click Publish again
  4. Whathead automatically retries only the 5 failed campaigns
  5. Verify all campaigns are now live
You don’t need to republish the 25 successful campaigns.

​
Next Steps

Now that you understand bulk publish, explore these related topics:

Bulk Edit

Edit multiple campaigns before bulk publishing.

Publishing Workflow

Understand the complete publishing process.

Validation Errors

Learn about common validation errors and resolutions.

Publishing Scenarios

Explore specific publishing scenarios and edge cases.

​
Common Questions

There’s no hard limit, but we recommend publishing no more than 100 campaigns at once for optimal performance. For larger batches, split into multiple publish operations.
Campaigns that were already published remain live on platforms. Campaigns that were in progress may fail. Retry publishing after your connection is restored—Whathead will skip successful campaigns and only retry failed ones.
Yes. Whathead processes campaigns for different platforms independently. If one platform fails, campaigns for other platforms can still succeed.
No, unless you’re publishing canvas-origin campaigns multiple times. Campaigns loaded from platforms with existing IDs will UPDATE, not CREATE duplicates. See Create vs Update for details.
No. Once campaigns are published, they remain live on platforms. You can pause or delete campaigns in platform portals, but Whathead doesn’t automatically roll back published changes.
Successful campaigns remain live on platforms. Failed campaigns show error messages on the canvas. Fix the errors and retry publishing—Whathead will only attempt failed campaigns, not successful ones.
After bulk publishing, the progress panel shows success/failure status for each campaign. You can also check platform portals to see which campaigns are live.
Yes. Click the Cancel button in the progress panel. Campaigns that already published remain live, but pending campaigns won’t be published.

Publishing Workflow

Understand the complete publishing process and validation.

Bulk Edit

Edit multiple campaigns before publishing them in bulk.

Publishing Scenarios: Multi-Campaign

Learn how Whathead handles publishing multiple campaigns simultaneously.

Validation Errors

Understand validation rules that apply during bulk publishing.

Troubleshooting Publishing Failures

Get help with publishing errors and partial failures.

Bulk Campaign Management Workflow

Follow a complete workflow for managing campaigns at scale.