Documentation

1. Install

Download the build for your operating system from your purchase email or the Download button on the home page. Pinterify ships for Windows, macOS, and Linux.

Windows 10 / 11

1. Double-click Pinterify-Setup-X.Y.Z.exe.
2. Windows may show a SmartScreen warning ("Windows protected your PC"). Click More info → Run anyway. This is one-time per version, normal for unsigned installers.
3. The wizard installs to %LOCALAPPDATA%\Programs\Pinterify for your user account — no admin password needed.
4. Launch from the Start Menu or the desktop shortcut.

macOS (Apple Silicon — M1 and newer)

1. Open Pinterify-X.Y.Z-arm64.dmg and drag Pinterify into Applications.
2. The app is unsigned, so double-clicking it shows "cannot be opened because the developer cannot be verified". Instead right-click the app → Open → Open. macOS remembers the choice after that.
3. If macOS still refuses, open Terminal and run xattr -cr /Applications/Pinterify.app, then launch it normally.

Linux (x64)

1. Download Pinterify-X.Y.Z.AppImage.
2. Make it executable: chmod +x Pinterify-X.Y.Z.AppImage
3. Run it: ./Pinterify-X.Y.Z.AppImage — no installation, no root.

2. First-time launch & free trial

On first launch, Pinterify automatically starts a 3-day premium free trial — no card, no signup. Every feature is unlocked: Keyword Research, Article Studio, Pin Studio, Bulk Pins, Board plans, the Pin Scheduler, Growth Analytics, and the Command Sheet. The top-right corner shows a live countdown TRIAL · 2d left.

After 72 hours the trial expires and the app gates behind the License page. Paste a paid license key (it looks like PNFY-XXXX-XXXX-XXXX) there to continue. Your keywords, articles, pins, and schedules all stay safe during the transition.

3. Connect an AI provider

Pinterify writes your articles, pin prompts, and descriptions with the model you choose. Four providers are supported — pick at least one:

• Claude (Anthropic) — works with your existing Claude Pro/Max subscription via the Claude Code CLI. Free for you (no extra API cost). Install Claude Code, run claude login, then Pinterify auto-detects the session.
• OpenAI (ChatGPT) — needs an API key from platform.openai.com.
• Gemini (Google) — needs an API key from aistudio.google.com.
• OpenRouter (multi-model) — one key unlocks 200+ models (Claude, GPT-5, Llama, DeepSeek, Mistral, Grok, etc.). Sign up at openrouter.ai.

Open the AI Providers page from the sidebar, paste your key, click Test connection, then Save. The TopBar pill flips to "OpenRouter connected" (or whichever provider) once it's wired up.

4. Connect your website

Every pin needs somewhere to send its click. Click Sites in the sidebar and connect the platform your blog runs on:

• WordPress — paste your site URL, username, and an Application Password. Click Test then Save.
• Ghost — paste your Admin API key from Ghost Settings → Integrations.
• Blogger — sign in with the Google account that owns the blog and grant publish access.
• Shopify — connect a custom app token with blog write scope; articles land on your store blog.
• Wix — authorize Pinterify from your Wix dashboard and pick the target blog.
• Next.js — paste your custom API endpoint + token, or wire up a GitHub repo for direct commits.

Once a site is connected you can set it as the auto-publish target in Article Studio. Published article URLs flow straight into the Command Sheet and the Pin Scheduler.

5. Keyword Research

Keyword Research is where every campaign starts. It searches a database of 20,000+ Pinterest interests and expands any seed keyword through autosuggest A–Z expansion — the same suggestions Pinterest shows real users, mined systematically from "a" to "z".

• Evergreen vs seasonal tagging — every keyword is flagged so you know whether to publish now or time it for Q4, spring, or a holiday spike.
• Commercial-intent filter — flags keywords whose results are dominated by products and ads, so you don't waste articles on feeds you can't win.
• Search-volume tiers — keywords are bucketed into volume tiers so you can balance quick-win long-tails against high-volume head terms.
• Long-tail expansion — one click appends proven modifiers like ideas, designs, and tips to multiply one seed into dozens of rankable variations.

Select the keywords you want to pursue and send them to the Command Sheet — the rest of the pipeline picks them up from there.

6. Article Studio

Article Studio turns each keyword into a Pinterest-ready article built to earn the click after the pin:

• Titles constrained to 40–60 characters and meta descriptions capped at 150 characters — sized for both Google snippets and pin link previews.
• Keyword-first H2s so Pinterest and Google both read the page structure the same way.
• 3–8 FAQ blocks per article to capture long-tail questions.
• Image slots with keyword alt text placed through the body — every image doubles as a pinnable asset.
• A 1200×628 featured image generated for social link previews.

Pick a connected site as the publish target and articles go live as they finish generating. The live URL is written back to the keyword's Command Sheet row automatically.

7. Pin Studio

Pin Studio produces the creatives: 2:3 ratio, 1000×1500 — the exact format Pinterest's feed rewards.

• Style-matched prompts — Pin Studio researches the top-performing pins for your keyword and generates image prompts that match the visual style already winning in that feed.
• Batch generation — queue an entire keyword list and generate every pin variation in one run.
• Text-overlay presets — proven title-overlay layouts with automatic color and contrast adjustment, so text stays readable on any background.
• Filename shuffler — every exported image gets a unique, duplicate-safe filename so batches never collide or get flagged as repeats.

8. Bulk Pins

Pinterest reads descriptions through its annotation system — Bulk Pins writes for exactly that reader. For each keyword it pulls the the page content and weaves them into copy:

• Pin descriptions — up to 500 characters, built on a 3-sentence structure: context + keyword, then the benefit, then a save CTA.
• Board descriptions — up to 300 characters, exact-match phrasing aligned to how Pinterest categorizes the topic.

Descriptions save to the keyword's Command Sheet row, ready for the scheduler.

9. Board plans

Boards tell Pinterest what your account is about — Board plans keeps them clean:

• Official-interest naming — board names are drawn from Pinterest's own interest taxonomy, not invented labels.
• One topic per board — validation warns you before you mix topics and dilute a board's signal.
• Review reminders — every board gets a 30–60 day review reminder so descriptions and covers stay current.
• Duplicate detection — flags overlapping boards before they start competing with each other.

10. Pin Scheduler

The scheduler publishes at the pace Pinterest rewards and blocks the patterns it punishes:

• 8–12 pins per day — the sweet spot is enforced automatically; the scheduler spreads your queue to stay inside it.
• 4–5 pins per URL per batch, rotated across at least 2 URLs and 5 boards so no single destination gets hammered.
• Scout-pin slots — 2–4 slots a day are reserved for testing new keywords and designs against your proven queue.
• Bulk-cap protection — dumps of 50+ pins are blocked outright; big batches are converted into a 20–30 day drip instead.

Load a keyword's pins from the Command Sheet, pick boards, and the scheduler builds the calendar. Set it once, walk away.

11. Growth Analytics

Analytics in Pinterify are outbound-click-first — impressions are vanity, clicks pay. The dashboard checks your numbers against real benchmarks:

• Save rate — healthy pins land between 2–5%.
• Click rate — healthy pins land between 1–3%.
• Gold-post detection — when a post shows high revenue-per-thousand and high traffic together, Pinterify flags it and auto-plans 20–25 new pins to pour fuel on it.
• Stable-pin refresh — pins that plateau get a refresh reminder at the 2–3 month mark, with new creatives queued from Pin Studio.

12. Command Sheet

The Command Sheet is the single source of truth for the whole pipeline. Every keyword gets one row carrying:

• Search volume tier and its top Pinterest annotations.
• Article title, meta description, and the published URL.
• Pin titles and descriptions, the target board, and live pin URLs.
• Status — Done / Not Yet / Scheduled — so nothing gets published twice or forgotten.

It's built for delegation: hand the sheet to a VA or teammate and they can run the entire workflow without touching your strategy. Export it any time to share or archive.

13. License activation & management

Open the License page from the sidebar. Your key arrives by email after purchase and looks like PNFY-XXXX-XXXX-XXXX. From this page you can:

• Activate a license key (one PC per key, hardware-bound).
• Re-check license status manually.
• Deactivate & release seat — moves your license to a new PC. Click here first, then activate the same key on the new machine.
• View your machine fingerprint (for support inquiries).

14. Troubleshooting

License says "wrong machine"

Your license is currently bound to a different PC. On the OTHER computer, open Pinterify → License page → Deactivate & release seat. Then come back here and activate the same key. If you no longer have access to the other machine, email hello@pinterify.app with your license key and we'll release the seat manually.

AI provider won't connect

Click Test connection on the AI Providers page and read the message. The usual causes: a key pasted with a trailing space, an expired key, or a provider account with no credit. Generate a fresh key from the provider dashboard and re-save. For Claude via CLI, run claude login again and restart Pinterify.

The scheduler refused my batch

That's the safety system working. Batches of 50+ pins are blocked by design, and queues that would exceed 8–12 pins/day or hit one URL too hard get spread automatically. Accept the suggested 20–30 day drip plan — it protects your Pinterest account.

Articles publish but pins fail

Check that the article's live URL appears in its Command Sheet row — pins can't schedule without a destination. If the URL is there, open the Activity log at the bottom of the screen, find the red error rows, and email a screenshot to hello@pinterify.app with your Pinterify version (visible in the sidebar) and the keyword that failed.

Still stuck? Email hello@pinterify.app. We respond within 6 hours on business days.