Writrex Documentation

Complete reference for every feature in Writrex — the AI local SEO content generator for WordPress.

Writrex generates local SEO pages, blog posts, and WooCommerce content directly inside WordPress. It connects to AI providers using your own API key, runs every piece of content through a quality gate before publishing, and auto-fills your SEO plugin with titles, meta descriptions, and focus keyphrases.

This documentation covers every feature, setting, and option in detail.

Requirements

Installation

1. 1
   Download the plugin

   Download the Writrex plugin zip file from writrex.com/downloads.
2. 2
   Upload to WordPress

   Go to WordPress Admin → Plugins → Add New → Upload Plugin. Select the downloaded zip file and click Install Now.
3. 3
   Activate the plugin

   Click Activate Plugin after installation completes. You will see a new Writrex menu item appear in your WordPress admin sidebar.
4. 4
   Enter your API key

   Go to Writrex → Settings. Select your preferred AI provider and enter your API key. The plugin will not generate content until at least one valid API key is configured.
5. 5
   Generate your first page

   Go to Writrex → Pages. Enter a keyword and target location. Click Generate. Your first page will be created as a draft within 30-60 seconds.

First Setup Checklist

AI Providers

Writrex connects directly to your chosen AI provider using your own API key. You pay the AI provider directly for usage — typically £0.01 to £0.05 per generated page. Writrex never charges for AI usage or marks up API costs.

Four providers are supported. You can switch provider at any time from Settings, and configure a fallback provider that activates automatically if your primary provider fails.

Google Gemini

Gemini is Google's AI model and the recommended starting provider for most users. It offers excellent quality at low cost with generous free tier limits for testing.

Getting your API key

1. 1
   Go to aistudio.google.com

   Open Google AI Studio in your browser.
2. 2
   Sign in

   Sign in with your Google account.
3. 3
   Create an API key

   Click Get API Key → Create API Key.
4. 4
   Copy the key

   Copy the generated key to your clipboard.
5. 5
   Paste into Writrex

   Settings → Gemini API Key, then Save.

Available models

Temperature setting

Temperature controls how creative versus predictable the output is. The default is 0.8 — balanced. Increase toward 1.0 for more varied, creative output. Decrease toward 0.3 for more predictable, structured output. For local SEO pages, 0.8–0.95 is recommended.

OpenAI

OpenAI's GPT models produce consistently high-quality output and are particularly strong for longer-form content and detailed FAQ sections.

Getting your API key

1. 1
   Go to platform.openai.com

   Open the OpenAI platform site.
2. 2
   Create an account or sign in

   Use existing credentials or register.
3. 3
   Create a new secret key

   API Keys → Create new secret key.
4. 4
   Copy the key immediately

   It is only shown once after creation.
5. 5
   Add billing

   Add credits at platform.openai.com/billing.
6. 6
   Paste into Writrex

   Settings → OpenAI API Key, then Save.

Available models

Anthropic Claude

Claude models are known for producing natural, human-sounding output — particularly well-suited for the humanisation goals of Writrex's quality system.

Getting your API key

1. 1
   Go to console.anthropic.com

   Open the Anthropic console.
2. 2
   Create an account

   Sign up or sign in.
3. 3
   Create a key

   API Keys → Create Key.
4. 4
   Add billing credits

   Top up before first use.
5. 5
   Paste into Writrex

   Settings → Anthropic API Key, then Save.

Available models

Perplexity

Perplexity has web search built in, making it uniquely useful for generating content with current, researched information. Writrex uses Perplexity as both a primary provider and as a research source when the Research Brief feature is enabled.

Getting your API key

1. 1
   Go to perplexity.ai

   Open Perplexity.
2. 2
   Settings → API

   Navigate to the API section.
3. 3
   Generate a new API key

   Create a new key for Writrex.
4. 4
   Paste into Writrex

   Settings → Perplexity API Key, then Save.

Using Perplexity for research

When Perplexity Research is enabled in Settings, Writrex sends a research query to Perplexity before generating content. The research results are injected into the prompt to make the output more specific and current. This is particularly useful for location-specific pages where local facts improve quality.

Fallback Provider

A fallback provider activates automatically if your primary provider returns an error — for example, if the API is temporarily unavailable or you have exceeded rate limits.

Configure the fallback in Settings → AI Provider → Fallback Provider. Select any provider for which you have a valid API key. The fallback only activates on failure — it does not run on every generation.

Generating Local Pages

Local pages are the core output type in Writrex. Each page targets a specific keyword and location — for example "Plumber in Manchester" or "Takeaway website design in Leeds".

Generated pages are saved as WordPress pages or posts and go through the quality gate before publishing.

How to generate a local page

1. 1
   Open the Pages tool

   Writrex → Pages in the WordPress admin.
2. 2
   Enter your target keyword

   e.g. "web design for restaurants".
3. 3
   Enter the target area

   e.g. "Birmingham".
4. 4
   Select content type

   Local Page, Service Page, or use a template.
5. 5
   Configure optional settings

   Tone, audience, word count, CTA URL.
6. 6
   Click Generate

   Wait 30–60 seconds for generation.
7. 7
   Page appears as a draft

   Visible in your WordPress Pages list.
8. 8
   Review the Quality Checklist

   Shown in the post editor meta box.
9. 9
   Approve & Publish

   Click when satisfied with the result.

Generation options

Generating Blog Posts

Blog posts are generated through Writrex → Blog Posts. They support a broader range of options than local pages — including FAQ sections, reading level, target audience, and CTA blocks.

Blog post options

WooCommerce Product Content

Writrex generates product descriptions, short descriptions, and SEO meta data for WooCommerce products. Content is generated in bulk across selected products and applied directly to the product records.

WooCommerce must be installed and activated for this feature to appear.

How to generate product content

1. 1
   Open WooCommerce tool

   Writrex → WooCommerce.
2. 2
   Select products

   Choose the products to generate content for.
3. 3
   Choose generation options

   Tone, brand profile, word count.
4. 4
   Click Generate

   Content is created for each selected product.
5. 5
   Review and publish

   Each product can be reviewed before saving.

WooCommerce Category Pages

Category page content is separate from product content. Writrex generates longer-form content for WooCommerce category archive pages — useful for SEO on competitive category terms.

1. 1
   Open Category tool

   Writrex → WooCommerce → Categories.
2. 2
   Select categories

   Pick one or more category archives.
3. 3
   Configure options

   Tone, brand profile, word count.
4. 4
   Click Generate

   Content is applied to the category archive.
5. 5
   Review and save

   Edit if needed, then save.

Bulk Campaigns

Bulk campaigns let you generate multiple pages or posts in a single scheduled run. Enter a list of keyword and area combinations, set a schedule, and Writrex generates each piece automatically using WordPress's WP-Cron system.

Bulk campaigns are particularly useful for local SEO agencies building location-specific landing page sets for clients.

Setting up a bulk campaign

1. 1
   Open Bulk Campaign

   Writrex → Pages → Bulk Campaign.
2. 2
   Enter keyword/area rows

   One combination per row.
3. 3
   Choose content type

   Page, post, or product.
4. 4
   Select a schedule

   Run once, hourly, daily, or specific time.
5. 5
   Configure shared settings

   Tone, brand profile, template.
6. 6
   Click Schedule Campaign

   Writrex queues each item.
7. 7
   One item per cron interval

   Avoids server overload during processing.

Campaign limits and pacing

*/5 * * * * wget -q -O - https://yoursite.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

Replace yoursite.com with your actual domain. Add this to your server's crontab or in cPanel → Cron Jobs.

The Quality Gate

Every piece of content generated by Writrex passes through a quality gate before it can be published. Content that scores below the minimum threshold is held as a draft automatically — it never publishes without meeting the standard.

The default minimum score is 80/100. You can adjust this threshold in Settings.

Quality Scoring

The quality score is calculated across multiple signals:

Total possible: 100 points. Default publish threshold: 80 points.

Approve and Publish

After generation, every page shows a Quality Checklist in the WordPress post editor sidebar. This checklist displays each quality signal and whether it passed or failed.

When the overall score reaches the minimum threshold, an Approve & Publish button appears in the checklist. Clicking this button:

1. Sets the post status to Published
2. Triggers an IndexNow ping if configured
3. Requests a Google Search Console sync if connected
4. Logs the approval timestamp

Brand Profiles

Brand profiles store a set of configuration values for a specific client or brand. Instead of entering the same tone, services, and proof points every time you generate content, you save them once as a profile and apply it to any campaign.

This is particularly useful for agencies managing multiple client sites — each client gets their own profile.

Creating a Brand Profile

1. 1
   Open Brand Profiles

   Writrex → Brand Profiles.
2. 2
   Click Add New Profile

   Start a new profile record.
3. 3
   Enter the profile name

   Use the client business name for clarity.
4. 4
   Configure the fields

   See the field reference below.
5. 5
   Click Save Profile

   Profile is now available in generation forms.

Applying a Brand Profile

When generating content, select a brand profile from the dropdown in the generation form. All settings from the profile are applied automatically.

Profile settings can be overridden per-generation if needed — the profile is a starting point, not a lock.

Page Template System

Page templates define the layout and section structure of a generated page. Instead of generating unstructured HTML, a template uses named placeholder tokens that Writrex fills with AI-generated content.

Templates give you consistent page structure across all generated pages while allowing the AI to write unique content for each placeholder.

How placeholders work

{{HERO_TITLE}}    → AI generates the hero headline
{{HERO_SUBTITLE}} → AI generates the subtitle
{{INTRO_P1}}      → AI generates intro paragraph 1
{{FAQ1_Q}}        → AI generates FAQ question 1
{{FAQ1_A}}        → AI generates FAQ answer 1
... and so on

Using a Template

1. 1
   Enable "Use Template"

   Toggle in the generation form or Settings.
2. 2
   Select a template

   Choose from the dropdown.
3. 3
   Enter generation options

   Keyword, area, and any other fields.
4. 4
   Click Generate

   Writrex fills every placeholder with unique content.
5. 5
   Review the result

   Open the page in the post editor.

Template Editor

The Template Manager (Writrex → Template Manager) lets you create, edit, and manage your own templates. You can create templates from scratch using HTML with placeholder tokens, edit existing templates, preview them with sample content, import templates from other sources, or generate a new template using AI by describing the layout you want.

Placeholder reference

SEO Plugin Integration

Writrex automatically detects which SEO plugin is installed and writes SEO data directly to the correct database fields after generation. No configuration is needed. If a supported SEO plugin is active, Writrex fills it automatically.

What Gets Auto-Filled

After every generation, Writrex generates and saves:

Schema Markup

Writrex automatically generates JSON-LD structured data for every page based on its content type. Local pages receive LocalBusiness schema with business name, area served, and contact information. Blog posts receive Article schema. FAQ sections produce FAQPage schema. Product content uses Product schema.

Schema is written into the page header automatically and contributes to the Quality Gate's Schema signal.

Scheduling Content

Writrex uses WordPress's built-in WP-Cron system to process scheduled content automatically. You set up a campaign with your keyword/area list, choose a schedule, and Writrex processes one item at a time on each cron cycle.

Schedule options

• Run once (immediate)
• Every 5 minutes
• Hourly
• Daily at a set time
• Weekly

Managing Campaigns

View and manage all active campaigns under Writrex → Pages → Campaigns or Writrex → Blog → Campaigns. Each campaign shows:

• Total items / processed items
• Current status: active or paused
• Next scheduled run time
• Items remaining
• Per-item success or failure status

You can pause, resume, or delete campaigns at any time.

WP-Cron Setup

WordPress's default WP-Cron fires only when someone visits your site. For reliable scheduling — especially on low-traffic sites — replace it with a real server-side cron job pinging wp-cron.php directly.

*/5 * * * * wget -q -O - https://yoursite.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

Add this to your server's crontab or in cPanel → Cron Jobs. Replace yoursite.com with your domain.

Google Search Console Integration

Writrex connects to Google Search Console via OAuth to pull ranking data for your generated pages. When connected, you can see:

• Average position for each page
• Click and impression data
• CTR performance

This data appears in the post editor meta box for any Writrex-generated page that GSC has data for.

Connecting GSC

1. 1
   Open GSC settings

   Writrex → Settings → Google Search Console.
2. 2
   Enter OAuth credentials

   Client ID and Client Secret from console.cloud.google.com.
3. 3
   Click Connect to Google

   Open the Google OAuth authorisation screen.
4. 4
   Authorise access

   Approve Writrex's read-only access.
5. 5
   Select your property URL

   Pick the GSC property to link.
6. 6
   Click Save

   Connection is now active.

Content Decay Scanner

The content decay scanner identifies Writrex-generated pages that may need refreshing. It analyses date last modified, age of the content, GSC ranking signals (if connected), and whether the page was recently reviewed or regenerated.

Pages flagged by the scanner are shown with a priority level: High, Medium, or Low. You can regenerate flagged pages directly from the scanner view.

Go to: Writrex → Content Refresh.

IndexNow Auto-Ping

IndexNow is a protocol that tells search engines immediately when a page is published or updated. When Writrex publishes a page, it automatically pings the IndexNow API endpoint so search engines can crawl the new content faster.

No manual submission needed. The ping happens automatically on every publish action.

Setting up IndexNow

1. 1
   Open IndexNow settings

   Writrex → Settings → IndexNow.
2. 2
   Enter your IndexNow API key

   Get one free at indexnow.org.
3. 3
   Save Settings

   Activate IndexNow pings.
4. 4
   Automatic submission

   Every Writrex publish pings Bing, Yandex, and other IndexNow-compatible search engines.

Research Brief

The research brief feature uses Perplexity AI to research your topic before generating content. Writrex sends a structured research query and receives current, specific facts that are injected into the generation prompt.

This produces content with real local facts, current market context, and specific details — rather than generic information the AI already knows. Requires a Perplexity API key.

Enable in: Settings → Enable Perplexity Research.

E-E-A-T Enhancer

When the E-E-A-T enhancer is enabled, Writrex adds additional instructions to every generation pass focused on:

• Demonstrating first-hand experience
• Adding practical business-specific proof
• Including experience-led wording
• Avoiding generic filler
• Flagging claims that need verification before publishing

This produces content that more closely aligns with Google's E-E-A-T quality signals — particularly useful for service pages where expertise needs to come through.

Enable in: Settings → Enable E-E-A-T Enhancer.

Automatic Image Integration

Writrex can automatically find and attach a featured image to every generated page. Four stock image providers are supported, plus AI image generation.

Image source modes

• Stock only — uses configured stock provider
• AI only — generates images with DALL-E
• Stock with AI fallback — tries stock first, uses AI if no good match found
• AI with stock fallback — tries AI first, uses stock if AI fails

General Settings

Image Settings

Default Prompts

Writrex ships with default prompts for page and blog post generation. You can customise these prompts in Settings → Default Prompts.

Prompts support token substitution — use these tokens and they are automatically replaced at generation time:

Brand Voice Defaults

Brand voice defaults apply to every generation when no brand profile is selected. These settings establish your default tone, audience, and content rules across the whole site.