Fix Failed Publishes (Common Errors + Fixes)

Managing the Publishing Queue

When you schedule or publish content, it enters the Publishing Queue. This queue tracks the status of every post.

Queue Statuses

• Pending: Waiting to be processed.
• Scheduled: Set for a future date/time.
• Processing: Currently being sent to the platform.
• Published: Successfully posted.
• Failed: Encountered an error (see below).
• Cancelled: Stopped by user.

Viewing the Queue

1. Go to Integrations
2. Click the Queue button on a connected platform card
3. View the status of your posts

Retrying Failed Posts

IDEQO automatically retries failed posts up to 3 times. If it still fails:

1. Check the error message in the queue.
2. Fix the issue (e.g., shorten caption, reconnect account).
3. Click the Retry icon (refresh arrow) next to the failed post.

Common Publishing Errors

When a post fails to publish, IDEQO sends you a notification with the error code. Here are the most common errors and how to fix them.

Error: “Token Expired” or “Authorization Failed”

What it means: Your connection to the platform expired. This happens when you change your password or revoke permissions.

Fix:

1. Go to Settings > Integrations
2. Find the platform showing an error
3. Click Reconnect
4. Log in and grant permissions again
5. Retry publishing the failed post

How to prevent: IDEQO automatically attempts to refresh tokens for active integrations. Ensure your account remains active.

Full token refresh guide →

Error: “Image Size Too Large” or “File Too Large”

What it means: The media file exceeds the platform’s size limit.

Platform limits:

• Instagram: 30MB per image, 300MB per video
• LinkedIn: 8MB per image, 200MB per video
• Twitter/X: 5MB per image, 512MB per video
• TikTok: 1GB per video
• Facebook: 10MB per image, 1GB per video

Fix:

1. Compress the image/video using a tool like TinyPNG or HandBrake
2. Reduce video resolution to 1080p
3. Lower video bitrate to 10-15 Mbps
4. Re-upload to IDEQO
5. Retry publishing

💡 Tip

See Media Upload Requirements for complete file size limits and format requirements for each platform.

Error: “Invalid Image Dimensions”

What it means: The image doesn’t meet the platform’s aspect ratio requirements.

Required aspect ratios:

• Instagram Feed: 1:1 (square) or 4:5 (portrait)
• Instagram Stories: 9:16 (vertical)
• Instagram Reels: 9:16 (vertical)
• LinkedIn: 1.91:1 (landscape) or 1:1 (square)
• Twitter: 16:9 or 2:1

Fix:

1. Crop or resize the image to the correct ratio
2. Re-upload to IDEQO
3. Retry publishing

Pro tip: Use IDEQO’s image editor to crop to platform specs automatically.

Error: “Caption Too Long”

What it means: Your caption exceeds the platform’s character limit.

Character limits:

• Twitter: 280 characters
• Instagram: 2,200 characters (first 125 visible)
• LinkedIn: 3,000 characters
• Facebook: 63,206 characters (but first 400 recommended)

Fix:

1. Edit the caption to shorten it
2. Move some content to a comment or thread
3. Retry publishing

Error: “Video Format Not Supported”

What it means: The video codec or container isn’t supported by the platform.

Supported formats:

• Instagram: MP4, MOV (H.264 codec)
• LinkedIn: MP4, AVI, MOV
• Twitter: MP4, MOV
• TikTok: MP4, MOV, MPEG, AVI, WMV

Fix:

1. Convert the video to MP4 with H.264 codec (use HandBrake or similar)
2. Re-upload to IDEQO
3. Retry publishing

Error: “Rate Limit Exceeded”

What it means: You posted too many times in a short period. Platforms have hourly/daily limits.

Platform limits:

• Instagram: ~25 posts per day
• LinkedIn: No official limit but avoid more than 5-10/hour
• Twitter: 300 tweets per 3 hours
• Facebook: 50 posts per day per page

Fix:

1. Wait 10-60 minutes
2. Spread posts out more (use IDEQO’s scheduling to avoid bursts)
3. Retry publishing

Error: “Duplicate Content Detected”

What it means: You’re trying to post identical content to what you recently posted.

Fix:

1. Change the caption slightly
2. Swap the image for a different one
3. Wait 24 hours and retry

ℹ️ Note

Instagram is especially sensitive to duplicate content. Vary your posts to avoid this.

Error: “Account Not Found”

What it means: The connected account was deleted, disabled, or you lost admin access.

Fix:

1. Check that the account still exists and you have access
2. If account was deleted, remove it from IDEQO and connect a new one
3. If you lost admin access, ask the owner to restore your permissions
4. Reconnect the account in Settings > Integrations

Error: “Hashtag Limit Exceeded”

What it means: You used too many hashtags.

Hashtag limits:

• Instagram: 30 hashtags per post
• LinkedIn: 3-5 recommended (no hard limit)
• Twitter: Best practice 1-2

Fix:

1. Remove excess hashtags
2. Move hashtags to first comment (Instagram only)
3. Retry publishing

Error: “Link Not Allowed”

What it means: The platform restricts or flags the link you’re trying to share.

Common causes:

• Shortened links (bit.ly, etc.) flagged as spam
• Links to blacklisted domains
• Too many links in one post

Fix:

1. Use full URLs instead of shortened links
2. Test the link in a browser to make sure it’s not broken
3. Reduce number of links per post
4. Retry publishing

Error: “Location Not Found”

What it means: The location tag you added doesn’t exist on the platform.

Fix:

1. Search for a different location name (try adding city/state)
2. Remove the location tag
3. Retry publishing

Platform-Specific Issues

Instagram

“This account can’t use Publishing API” → Your account must be a Business or Creator account, not Personal. Convert to Business account →

“Story sticker not supported” → Some Story stickers (polls, questions) require manual posting through Instagram app.

LinkedIn

“Company Page not authorized” → You need Super Admin access to the LinkedIn Page. Check permissions in LinkedIn Page settings.

Twitter/X

“Tweet flagged as spam” → Avoid repetitive tweets or excessive hashtags/mentions. Wait 24 hours and rephrase the tweet.

TikTok

“Video too short” → TikTok videos must be at least 3 seconds long. Trim or extend the video and retry.

If Nothing Works

If you’ve tried all fixes and still can’t publish:

1. Test the platform directly — Try posting manually through the native app to see if the issue is platform-wide
2. Check platform status — Visit https://downdetector.com to see if the platform is down
3. Contact IDEQO support — Go to Settings > Support and include:
   • Error message
   • Post ID
   • Screenshots
   • What you’ve tried so far

💡 Tip

Most errors are fixed in under 5 minutes once you know the cause. Bookmark this page for quick reference.

Prevent Future Errors

Best practices:

• Keep platform connections refreshed (reconnect every 60 days)
• Test posts with small test accounts before scheduling to client accounts
• Check file sizes before uploading
• Stay within platform limits (file size, caption length, hashtags)

Next Steps

Media Upload Requirements

File sizes, video lengths, and format requirements for each platform. View requirements →

Token Refresh Guide

Keep your platform connections active and prevent authorization errors. Read guide →

Common Questions

Find answers to frequent IDEQO questions. View FAQ →

---

Still stuck? Contact support with your error message.