Documentation
How to use every part of Zolyp, then every limit, requirement and fix: the same numbers publishing actually enforces.
Getting started
Zolyp is an AI social media team: it learns your brand, writes and designs posts, and publishes them to every platform you connect.
Onboarding, step by step
- 1Enter your website. Zolyp reads it to learn what you do.
- 2Tell it about your business: its name, what kind of business it is, and topics to stay away from.
- 3Pick a voice: Warm & human, Clear & professional, Bold & punchy, Storyteller, or Playful & witty.
- 4Choose your goals, such as more bookings, reach, engagement or sales.
- 5Pick a posting rhythm: 3, 5 or 7 posts a week.
- 6Connect your social accounts now, or later from Connections.
- 7Build your first post.
Free trial
Every account starts with a 3-day free trial: 6 images and 3 posts, whichever runs out first. Video generation unlocks when you choose a plan.
Your AI team
Each part of the work has a named teammate, so you always know who did what:
- Zee, Managing Director
- Olivia, Brand Strategist: plans what to post
- Lina, Content Writer & Creative Design: writes captions, makes images
- Yoongi, Publishing Lead: sends posts out and retries failures
- Pareesa, Insights Analyst: reads your results
Brand Brain
Everything Zolyp knows about your brand, in plain language you can edit. Every post, image and caption is written from it, so the more complete it is, the more on-brand your posts are.
What's in it
- Brand info: name, website, email, phone, social handle, address and your brand's timezone.
- Your business: what you do, your industry, services, locations, competitors, and boundaries you don't want crossed.
- Voice: your main goal, topics to never post about, and sliders for how formal, warm and playful you sound.
- Look & feel: your logo (for light and dark backgrounds), photo style notes, and designs you love as inspiration.
- Colors and fonts: your primary color, with secondary, text and surface colors filled in automatically, plus a contrast check.
- Customer reviews you approve, so posts can quote real customers.
Keeping it up to date
- Re-analyse reads your website again whenever your business changes.
- Website content lets you browse the pages Zolyp read and edit what it took from them.
- Customization rules add things every post should include, such as your phone number or address.
- What's working shows what Zolyp has learned from your results. Dismiss anything that isn't right.
- Turn on “Add my logo to published images” to stamp your logo on every post.
Connecting accounts
Connect each social account once, under Connections. Zolyp publishes through it until you disconnect it.
Connecting
- Click Connect on a platform and approve every permission it asks for.
- Facebook posts go to a Page. If your account manages more than one Page, pick the default Page here.
- Pinterest needs a board to pin to. Pick a default board. Create one on Pinterest first if you have none.
- Google Business accounts with several locations pick a default location here.
- Sync accounts refreshes your Pages, boards and locations after you change them on the platform.
When a connection needs attention
If you change a platform password or a token expires, the account shows Reconnect needed and Home shows a Fix it now prompt. Click Reconnect and approve again. Nothing else changes.
Creating a post
Click Create on the Posts page. You can make one post or several at once, and every step can be done by you, by Zolyp, or a mix.
The steps
- 1Media. Choose the post type (Image, Text or Video), the platforms, the media, and when it should go out.
- 2Idea. Say what the post is about, and optionally add up to 3 reference images. Skipped when you upload your own media.
- 3Caption. Write the caption and hashtags, or click Auto-fill. Each platform gets its own tab, tailored to its style and limits.
Text posts are a single step: the caption is the post.
Image posts
- Auto-generate: Zolyp designs the image from your idea and brand. Pick a template or style, a size (Portrait 4:5, Square 1:1 or Landscape 1.91:1) and an image quality.
- Carousels: choose up to 5 images. Platforms that can't take that many images in one post are hidden automatically.
- Upload: use your own photos, from your device or your Library, up to 15 MB each.
- Text image: a clean typographic poster with no photo, which uses no image credits.
- Brand mark: stamp your logo on the image, per post.
Video posts
- Generate: describe the video (or click Auto-fill) and pick a model, a shape (16:9 or 9:16), a resolution and a length. Rendering takes a minute or two.
- Upload: attach your own video, up to 95 MB. Zolyp looks at frames from it to write a caption that matches.
- Click the video preview to play it full size before you post.
- Video posts can have a thumbnail: generate one, or pick one from your device or Library. It's used on YouTube, Instagram, Facebook (Video format), LinkedIn, X and Pinterest; TikTok shows a frame of the video.
Platform options
- YouTube, Pinterest, LinkedIn and TikTok photo posts have their own title field.
- TikTok: add music or a location, choose who can see it, and allow or block comments, duets and stitches.
Scheduling and drafts
- Pick a date and time. Past times can't be picked. When you create several posts, each lands one day after the previous one.
- The post is saved the moment you click Create. You can refresh or close the tab while Zolyp finishes it. It shows as Creating, then moves to Scheduled.
- Close the dialog any time and choose Save draft to keep your work. A draft saves exactly what you picked and generates nothing. Open it later to carry on from the same step.
Managing posts
The Posts page holds every post: tabs for All, Drafts, Scheduled, Published and Failed, plus filters by campaign and date, and search by name or post ID.
Post statuses
- Draft
- Saved but not scheduled. Nothing goes out until you schedule or publish it.
- Creating
- Saved, and Zolyp is still writing its copy or making its image or video. It moves on by itself.
- Needs review
- Written by your AI team and waiting for your approval.
- Scheduled
- Waiting for its publish time.
- Publishing
- Going out to the platforms right now.
- Published
- Live on its platforms.
- Failed
- At least one platform didn't take it. The card says why and offers Retry publish.
What you can do with a post
- Schedule, reschedule, or publish now.
- Edit: open a draft to carry on in the Create dialog, or any other post to review and change it.
- Duplicate: a copy is saved as a draft, one day later.
- Retry publish on a failed post. Only the platforms that failed are sent again, so nothing is posted twice.
- Republish to the platforms you choose, including ones the post didn't go to the first time.
- Unpublish removes a live post from the platforms that allow it, even when the post failed elsewhere.
- Change the thumbnail on a published YouTube video.
- Download the image, copy the post ID, or delete the post.
- Select several posts to delete them together.
Most of these live in the ⋮ menu on each post card. Hover over a video to play it.
Reviewing & editing
Posts your AI team writes wait for your approval. Open any post to review it, change it, or see how it did.
Reviewing
- Approve to schedule it as it is.
- Change with a note: tell Lina what to change in your own words, and she rewrites that platform’s caption.
- Regenerate for a fresh take, or Send back to Olivia with a reason. “Doesn’t sound like us” and “Facts are wrong” hide the post and teach Olivia for future posts. “Image needs work” keeps the words and makes a new image. “Not the right time” moves it to Drafts.
- Keyboard: A approve, E edit, R send back, N note.
Changing the image
- Upload or replace a photo, or add more to make a carousel.
- Edit the image with a prompt, optionally with a reference photo.
- Redesign for new creative directions as text, image or video, and go back to earlier versions from the history.
Post details
Clicking a post opens its details: when it was created, scheduled and published, its campaign, likes, comments, views, reach, saves and shares, and its comments. You can reply to and delete comments from here on the platforms that support it.
Campaigns
A campaign plans and creates a run of posts for you: a few days of content, or an autopilot that keeps going week after week.
Creating a campaign
- 1Basics: name the campaign.
- 2Content: where posts come from: your website, chosen pages from it, your own images or videos, or your own prompts.
- 3Platforms: where the posts go, and the media type (image, text, video or a mix).
- 4Schedule: 3, 5 or 7 days (or up to 30), or Autopilot, which builds next week's posts every Sunday. Set 1 to 3 posts a day, the posting days, an optional time and your timezone.
- 5Templates: pick the designs to rotate through.
- 6Review: check the summary and create it. Close at any step to save a draft.
Running a campaign
- Pause and activate it, archive and restore it, or cancel it.
- View posts to see only that campaign's posts on the Posts page.
- Deleting a campaign deletes its posts, including any still scheduled.
- If there aren't enough image credits for the whole campaign, you're warned before it starts.
Calendar
See everything that's scheduled and published, by timeline, week or month, in any timezone.
- Drag a post to another day or time to reschedule it.
- Ask Olivia for a post to have one drafted for a day.
- Click a post to open its details.
Library & templates
Your own media, and the designs Zolyp creates posts from.
Library
Keep your photos and videos in folders, ready to drop into any post. Upload or drag files in, create, rename and delete folders, and remove items.
Templates
Browse every design style, filter by category or favourites, and search. Preview a template, then click Create post to start a post in that style. The Text templates are typographic designs that use no AI and no image credits.
Analytics & reports
How your posts and accounts are doing, over 7, 30 or 90 days, across all platforms or one.
- Reach over time, which formats perform best, and how results split across platforms.
- A sortable table of every post's results.
- Your audience: when followers are online, followers gained and lost, age, country and city.
- Hashtag and search ideas for each platform.
- Download a month as a PDF, or have Pareesa write a weekly report you can share by link.
- Google Reviews (with Google Business connected): see your rating and reviews, and reply to them.
Credits & billing
Plans include monthly credits for AI work. Scheduling and publishing never cost credits.
What uses credits
- Images: 2 credits at Low quality, 4 at Medium, 8 at High, for each image. A carousel costs that for every image.
- Videos: depends on the model, resolution and length. The cost shows before you create.
- Text: 1 credit each time you ask the AI to write, rewrite, adapt, research or chat.
- Failed runs are never charged.
The credits meter in the top bar shows what’s left. See Plan limits for each plan’s allowance.
Your plan
- Choose or change a plan under Subscription, monthly or annually.
- Settings → Billing has your plan, usage, payment method and invoices.
- Cancelling keeps your plan until the end of the period you paid for, and you can resume before then.
Team & settings
Invite your team, manage brands, and choose what you hear about.
Team
- Invite people by email as an Editor (create, edit and review posts, no billing) or an Owner (full access).
- Choose which brands each person can work on, change roles, and remove members.
- Preview as Editor shows you what an Editor sees.
Brands
Switch between brands from the brand switcher. Add a brand there while your plan has room for one. Each brand has its own Brand Brain, connections and posts.
Notifications
Choose which events you hear about (posts ready to review, posts published, weekly reports, connection problems, billing) and where: in the app, by email, or on WhatsApp. You can also pick your weekly review day.
Profile
Change your name, theme and password.
Refer & earn
Share your invite link. You earn a share of every payment the people you invite make, and they get money back too, for as long as they stay subscribed.
- Copy your invite link, or change it to something memorable.
- Track link opens, sign-ups, what's on the way and what you've earned.
- Add your bank details and request a payout once you reach the minimum balance.
Search & shortcuts
Press ⌘K (Ctrl+K on Windows) anywhere to search posts and templates, create a post, switch brand, or jump to any page.
- ⌘/ shows every keyboard shortcut.
- G then H, Q, C or A jumps to Home, the review queue, Calendar or Analytics.
- ⌘Enter saves.
- Help in the top bar restarts the product tour.
Reference
Limits, requirements and rules for each platform. Each section also has its own page: character limits, daily posting limits, media requirements, video requirements, platform rules, comments, retry & unpublish, plan limits, when a post fails.
Character limits
The composer's counters use these exact numbers: going over gets trimmed or rejected at publish.
| Platform | Caption | Title | Alt text |
|---|---|---|---|
| 2,200 | None | 1,000 | |
| 5,000 | None | No cap | |
| 3,000 | 400 | No cap | |
| Google Business | 1,500 | None | No cap |
| X | 280 | None | 1,000 |
| TikTok | 2,200 | 90 | No cap |
| YouTube | 5,000 | 100 | No cap |
| 500 | 100 | 500 | |
| Threads | 500 | None | 1,000 |
Daily posting limits
Per connected account, on a rolling 24-hour window. A post that hits the cap fails with a clear message and can be retried after the window clears.
50
posts / day
25
posts / day
150
posts / day
10
posts / day
15
posts / day
10
posts / day
20
posts / day
50
posts / day
Media requirements
Supported formats and maximums per platform. Media outside these gets rejected by the platform at publish time.
| Platform | Image formats | Max image size | Video formats | Max video length |
|---|---|---|---|---|
| PNG, JPG, GIF | No stated limit | MP4, MOV | 15 min | |
| JPG, PNG, GIF, WebP | No stated limit | MP4 | 1 min 30 sec | |
| JPG, PNG, GIF | No stated limit | MP4, WebM, MKV | 10 min | |
| Google Business | No stated limit | No stated limit | MP4 | 30 sec |
| X | JPG, PNG, GIF, WebP | 5 MB | MP4 | 2 min 20 sec |
| TikTok | JPG, WebP, PNG, GIF | 20 MB | MP4, WebM, MOV | 10 min |
| YouTube | Not supported | Not supported | any video format | No stated limit |
| BMP, JPG, PNG, TIFF, GIF, WebP | 20 MB | MP4, MOV, M4V | 15 min | |
| Threads | JPG, PNG | 8 MB | MP4, MOV | 5 min |
Instagram aspect ratios: square 1:1 · portrait 4:5 (best for feed) · landscape 1.91:1 · Stories/Reels 9:16. Images outside 4:5 – 1.91:1 are rejected: 1080×1350 is the safe default.
Video requirements
Enforced per-platform video limits. A video outside these gets rejected by the platform at publish time. Zolyp checks what it can (duration, size, format) before scheduling.
| Platform | Formats | Max size | Duration | Frame rate | Resolution / aspect |
|---|---|---|---|---|---|
| MP4, MOV | 300 MB | 3s – 15 min | 23–60 fps | up to 1920px wide · 0.01:1 to 10:1 (9:16 recommended) | |
| FacebookReel | MP4 | No stated limit | 3s – 1 min 30s | 24–60 fps | 9:16 |
| FacebookVideo | Any video format | 10 GB | up to 4 h | No stated limit | up to 4096px wide |
| FacebookStory | MP4 | No stated limit | 3s – 1 min | 24–60 fps | 9:16 |
| MP4, WebM, MKV | 500 MB | 3s – 10 min | 10–60 fps | 256–4096px wide · 1:2.4 to 2.4:1 | |
| Google Business | MP4 | 28 MB | up to 30s | No stated limit | No stated limit |
| X | MP4 | No stated limit | 0.5s – 2 min 20s | up to 60 fps | 32–1920px wide · 1:3 to 3:1 |
| TikTok | MP4, WebM, MOV | 4 GB | 3s – 10 min | 23–60 fps | 360–4096px wide |
| YouTube | Any video format | 256 GB | No stated limit | No stated limit | No stated limit |
| MP4, MOV, M4V | 1 GB | 4s – 15 min | No stated limit | between 1:2 and 1.91:1 (1:1, 2:3, 4:5 or 9:16 recommended) | |
| Threads | MP4, MOV | 1 GB | up to 5 min | 23–60 fps | up to 1920px wide · 0.01:1 to 10:1 (9:16 recommended) |
H.264 or HEVC video · AAC audio ≤48 kHz · video bitrate ≤25 Mbps.
Published as a Reel — 9:16 vertical, 1080×1920 recommended.
Bitrate 192 kbps – 30 Mbps.
Short video updates: up to 30 seconds. Larger files are re-encoded; over 28 MB is refused.
H.264 High Profile + AAC LC · closed GOP, progressive scan. Premium accounts can post longer videos (up to 125 minutes, 16 GB).
10 min is the API maximum — many accounts are capped at 3 or 5 min by TikTok itself. H.264 recommended.
Custom thumbnails need a verified channel and may not apply to Shorts.
H.264 or HEVC video · AAC audio ≤48 kHz · video bitrate ≤100 Mbps.
Platform rules
What each platform needs before a post can go out: the same checks publishing runs.
- Needs a Business or Creator account. Personal accounts can't connect.
- Reels, Stories, photos and carousels. Text-only posts are rejected.
- Images must be between 4:5 and 1.91:1 aspect ratio · 1080×1350 (4:5) works best for feed.
- Comments: you can reply to existing comments, but Instagram doesn't allow starting a new top-level comment from apps.
- Posts go to a Facebook Page, never a personal profile. Connect a Page, and pick a default Page under Connections if the account has several.
- You need Admin or Editor role on the Page.
- Video goes out as a Reel (vertical, up to 90 seconds), a Page video (any shape, up to 4 hours) or a Story (up to 60 seconds).
- On a post with several photos, the caption shows on the first photo.
- Text, link posts, photos (one, or a grid), swipe carousels (sent as a PDF), documents, polls and video.
- Posts go out as your profile or a company Page you manage (Connections → Post as).
- Photo, video and document posts take an optional title, up to 400 characters. Text posts have no title.
- Comments and analytics work only when posting as a company Page.
- Updates and events, with an optional button (Book, Order, Call…). Event titles up to 58 characters.
- One photo per update; or add a photo to your listing's Photos tab under a category. Short videos up to 30 seconds.
- Reply to reviews (and remove a reply) from the Reviews page.
- Single-location accounts publish automatically; multi-location accounts pick a default location under Connections (or per post in the composer).
- One post is 280 characters. Longer text goes out as a thread.
- X removes links from posts and replies. Put the link in your bio or on another platform.
- More than 4 photos are spread across a thread, 4 per post.
- Videos over 2 min 20 sec are rejected on standard accounts. Premium accounts can post longer videos.
- A custom video thumbnail needs a Premium account, and X may drop it.
- Video and photo posts both publish. Zolyp converts PNG and GIF photos to JPG for TikTok.
- You pick who can view each post. Comments, Duet and Stitch start off; turn them on per post. Branded content can't be private.
- Videos must be at least 3 seconds and within your account's own length limit.
- Send to TikTok drafts to finish a post in the TikTok app, for example to add a trending sound.
- Music, places, a custom cover and comments need an up-to-date connection. If one is missing, reconnect TikTok.
- On a photo post the caption doubles as the title; video posts have no separate title field.
- TikTok enforces its own anti-spam caps (~15 posts per rolling 24h per account); pending unpublished drafts in the TikTok inbox also block new uploads.
- Video only. An image post can't go to YouTube. Switch the post to video or drop YouTube from its platforms.
- Title required at publish, up to 100 characters.
- Custom thumbnails need a verified YouTube channel, and may not apply to Shorts.
- Visibility, tags and category can be changed after posting; Made for kids can't.
- Needs an image or video, and a board to pin to. Pick a default board under Connections, or one per post.
- No board yet? Create one under Connections. Secret boards can't take pins.
- Carousel photos must all be the same size.
- Pinterest sometimes briefly refuses a video pin. Zolyp tries again a few minutes later.
- One post is 500 characters, and an emoji counts as 4. Longer text goes out as a thread.
- Text, photos, carousels, video, polls, a topic and who can reply. A text post can carry a link card; up to 5 different links per post.
- A live Threads post can't be removed from Zolyp. Remove it in the Threads app.
Comments
Reading, replying to, and deleting comments from the post details drawer works on these platforms.
On Instagram you can reply to existing comments, but starting a new top-level comment isn't allowed by Instagram itself. LinkedIn comments work for posts made as a company Page. Threads replies can be hidden but not deleted.
Retry & unpublish
What happens after a post goes out: retrying a failure, and taking a live post down.
Retrying a failed post
- Only the platforms that failed are retried: anything that already went out stays untouched, so a retry can never double-post.
- Your image or video isn't re-uploaded: the retry reuses the media from the original attempt.
- Temporary failures (rate limits, platform hiccups, daily caps) retry on their own. The post card says so when they will. Hit Retry publish any time to retry immediately.
Unpublishing a live post
Unpublish (on the post card's menu) deletes the live copy from the platform. The post itself stays in Zolyp, ready to edit or re-send. Platforms that allow it:
Instagram, TikTok and Threads don't allow deleting a published post from outside their apps. Remove those in the app itself.
Plan limits
What each plan includes. Credits reset monthly.
| Plan | Brands | Image credits / mo | Video credits / mo | Text credits / mo | Campaigns | Research |
|---|---|---|---|---|---|---|
| Starter | 1 | 128 | 200 | 64 | No | No |
| Growth | 1 | 480 | 600 | 240 | ✓ | ✓ |
| Pro | 2 | 1,000 | 1,500 | 500 | ✓ | ✓ |
| Business | 5 | 2,500 | 4,000 | 1,250 | ✓ | ✓ |
| Enterprise | 10 | 5,000 | 6,000 | 2,500 | ✓ | ✓ |
Text credits cover AI prompts: composing, rewriting, or adapting a caption, “Fix with a note”, research, and chatting with your AI team each cost 1 credit per run, a separate pool from image credits, so prompts never eat into your image allowance. Image renders cost 2–8 credits depending on quality. Failed runs are never charged.
The three pools never cross, so running out of one doesn’t stop the others: with no image credits left you can still generate video, write captions, schedule, and publish. Scheduling and publishing posts you’ve already made never costs credits at all. Image and video credits can be topped up separately. A top-up balance never expires and is only spent once that month’s allowance is gone. Text credits have no top-up; a bigger monthly allowance means moving up a plan.
On the 3-day free trial you get 6 images, 3 posts, and 20 prompt credits. Video generation isn’t included until you upgrade, and trial allowances can’t be topped up.
When a post fails
Every failure shows a plain-language reason on the post card. Here's what the common ones mean and how to fix them.
Connection expired or revoked
Session expired, password changed on the platform, token invalid, “Unauthorized”.
Go to Connections, reconnect the account, and approve all requested permissions. If you recently changed the platform password, this is always the fix.
Account blocked on the platform
Account suspended, temporarily locked, restricted, or flagged as spam.
This must be resolved on the platform itself (facebook.com, x.com, the Instagram app…). Zolyp can't lift a platform restriction. Reconnect after it's cleared.
Media doesn't fit the platform
Wrong aspect ratio, unsupported size or format, video too long, image-only post sent to a video platform.
Check the media requirements and platform rules, adjust the media (or drop the platform from the post), then retry.
Daily limit or rate limit reached
The platform's daily posting cap is used up, or requests are briefly rate-limited.
These clear on their own: daily caps roll over on a 24-hour window (YouTube resets at midnight UTC). Failed posts retry automatically where it's safe to.
Temporary platform errors
“Service unavailable”, “temporary issue”, unexpected platform-side errors.
Nothing is wrong with your post. Wait a few minutes and retry. These almost always clear.
A post that failed on one platform can still be live on the others. Its analytics and comments keep working for the platforms that published. Retry only re-sends the platforms that failed.