WriteWP documentation for install, import, and automation

Getting started

WriteWP installs like any premium WordPress plugin — no external service to sign up for, no servers to configure. You will need WordPress 5.8 or newer running on PHP 7.4 or newer (WriteWP is built for WordPress 7.0+ and fully tested on the current stack), and an API key from at least one supported AI provider.

1. Download the writewp.zip file from your Freemius purchase receipt or account.
2. In your WordPress admin, go to Plugins → Add New → Upload Plugin, choose the zip, and click Install Now.
3. Click Activate. A new WriteWP menu item appears in the admin sidebar.
4. Open WriteWP → License and paste your license key to unlock your plan (Single Site, 10 Sites, 1,000 Sites, or 5 Sites Lifetime — see pricing).

Connecting AI providers

WriteWP never includes a built-in AI account — you bring your own keys, so there are no per-article fees and you stay in full control of usage and spend. Open WriteWP → Settings → Providers to add one or more of the supported services.

• OpenAI
• Google Gemini
• OpenRouter — Claude, DeepSeek, Grok, Mistral, Llama, and more
• MiniMax
• OpenCode Zen
• Ollama — local or self-hosted; no key required for local instances
• Pollinations — free featured images by default (no key required)

For each provider you add, paste the API key and pick the model you want to use. Then designate a primary provider for everyday rewriting and an optional fallback — if the primary is rate limited or returns an error, WriteWP automatically retries the job on the fallback so a run never silently stalls.

Automation & scheduling

Sources can run on autopilot. For any source in the Importer, attach a schedule and a default post status so new articles flow in without you lifting a finger.

• Schedule — choose how often WriteWP re-fetches a source (for example hourly, daily, or weekly).
• Post status — decide whether finished posts land as draft for review or go straight to publish.
• Duplicate protection — WriteWP tracks what it has already imported per source and skips items it has seen before, so re-fetching never creates duplicates.

// wp-config.php
define( 'DISABLE_WP_CRON', true );

# crontab — run WordPress cron every 5 minutes
*/5 * * * * curl -s https://example.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

SEO options

Rewriting is where WriteWP earns its keep — every job can apply SEO structure rather than just paraphrasing. Configure these per source or per job:

• Target keywords — guide the rewrite toward the terms you want each post to rank for.
• Search intent — frame the article as informational, commercial, or transactional so the angle fits the query.
• Internal linking — let WriteWP weave in links to your existing posts where they fit naturally.
• FAQ & table of contents — append a structured FAQ block and an on-page TOC for richer, scannable results.
• Slugs — generate clean, keyword-aware URL slugs instead of inheriting the source's.

The result is a post with sensible headings, a logical structure, and original phrasing — built to read well and rank, not to trip plagiarism or duplicate-content checks.

Importing articles

The Importer is where you connect ongoing sources — any RSS feed, a WordPress site, or a custom URL pattern. WriteWP fetches the latest articles, you choose which ones to process, and the AI rewrites them into original, SEO-structured posts.

1. Open WriteWP → Importer and click Add source.
2. Paste a feed or site URL. For an RSS feed, point it straight at the feed address, for example: https://example.com/feed/
3. Click Fetch. WriteWP lists the available articles with titles and previews.
4. Select the articles you want, then choose Rewrite & import. Each is rewritten into a fresh draft or published post per your settings.

You can keep several sources side by side and re-fetch any of them on demand or on a schedule (see Automation below).

Live import from a URL

Need a single piece right now? Use Live Import to paste any article link and queue it immediately — no source setup required. This is ideal for one-off pieces, news you want to react to quickly, or testing how a particular page rewrites.

1. Open WriteWP → Live Import.
2. Paste the full article URL, for example https://example.com/2026/an-article-to-rewrite/
3. Click Add to queue. The item appears in the live queue and WriteWP fetches, rewrites, and saves it according to your post-status setting.

Agentic chat

WriteWP chat is more than Q&A. On OpenAI, OpenRouter, and Gemini it can take real actions with built-in abilities:

• Create a blog post draft from a topic, brief, tone, or word count.
• Import and rewrite any URL through the same pipeline as Live Import (with duplicate checks).
• List recent posts and pull basic site context so replies stay on-brand.

On WordPress 6.9+, those same abilities register with the official Abilities API so external agents can discover them when the WordPress MCP Adapter is installed. Abilities always re-check admin permissions and default new posts to draft unless you explicitly ask to publish. Full overview: WriteWP Abilities.

Media Studio

The Media Studio generates the media your posts need, in one place. Imports and Writer drafts also get a free AI featured image automatically when the source has none (Pollinations by default — no API key required).

• Image — free Pollinations generation by default; optional OpenAI, Gemini, MiniMax, or OpenRouter for more control.
• Audio — produce voice narration from your post content.
• Video — generate short video assets to accompany a piece.
• Writer — draft or expand copy directly, separate from the import pipeline.

Paid Studio paths use the same providers you configured under Settings. Generated images save with SEO-friendly filenames and pre-filled alt text.

Cloudflare & protected sites

Some sources sit behind Cloudflare challenges. WriteWP includes a Cloud Solver with your subscription (Settings → Cloudflare) that auto-solves challenges on managed infrastructure. Advanced users can still point WriteWP at a self-hosted FlareSolverr instance, or paste a host-specific cf_clearance cookie when that is enough. Prefer RSS when the source publishes a clean feed — it is usually more reliable than scraping a protected HTML page.

Troubleshooting

Most issues come down to provider configuration or scheduling. Work through these first:

• Rate limit or provider error — set a fallback provider under Settings → Providers. WriteWP retries on the fallback automatically when the primary throttles or fails.
• Empty or truncated output — retry the job. Transient model timeouts can return short results, and a single retry usually resolves it. If it persists, try a different model or your fallback provider.
• Scheduled imports not running — this is almost always cron. Confirm the site gets traffic, or wire up real system cron as shown in Automation & scheduling.
• A source returns no articles — verify the feed URL loads in a browser and that you used the actual feed address (often ending in /feed/), not the homepage.
• License or activation problems — recheck the key under WriteWP → License, and make sure your active site count is within your plan's limit.
• Check the logs — the Activity and System screens surface recent errors and a health check to pinpoint what failed.

Frequently asked questions