Documentation
v1.0.3 — latest
Last updated May 2025

How can we help?

Everything you need to install, configure, and master AddiPress Pro — from first install to 40+ autonomous modules running your directory 24/7.

Popular:
🆕 New in v1.0.3
Swarm Agents, Salary AI, and 49 new WordPress hooks Multi-agent orchestration, real-time salary intelligence for job boards, full developer hook reference.
See full changelog →
Get up & running

Quick start in 4 steps

From download to fully automated directory in under 30 minutes.

01
📦

Download & Install

Upload the .zip via WordPress → Plugins → Add New → Upload. Activate with one click.

Installation guide →
02
🔑

Activate Licence

Go to AddiPress → Licence and paste your key. Unlocks all 40+ modules immediately.

Licence guide →
03
🤖

Connect OpenAI

Add your OpenAI API key in Settings → AI Config. All AI Agents activate instantly.

OpenAI setup →
04
🏭

Pick Your Preset

Choose your industry preset and let AddiPress configure SEO rules, content hooks, and fields automatically.

Browse presets →
Browse by topic

Documentation categories

🚀
Getting Started

Installation, licence activation, system requirements, first preset setup, and initial configuration wizard.

🤖
AI Agents
New Hot

AI Terminal, Runner, Swarm Agents, and Metacognition — configure multi-agent autonomous workflows.

🎯
SEO & SERP Tools
Hot

SERP Sniper, SEO Brain, Dominator, Programmatic SEO — schema markup, meta-tags, rank tracking.

✍️
Content Engine

AI-powered listing generation, Content Auditor, and Persona Engine — writing, auditing, and personalisation.

📈
Marketing & B2B
New

B2B Hunter, Growth Engine, Social Media AI, and Salary AI — lead generation, outreach, and pricing intelligence.

🏭
Industry Presets
Updated

Deep-dives into all 13 industry presets — what each preset configures, custom fields, and SEO rules.

📊
Analytics & Reports

AI Results dashboard, Market Index, revenue tracking, and automated performance reports.

💳
Monetisation

Paid listings, featured slots, membership tiers, and WooCommerce payment integration setup.

🌍
Localization & Languages
New

24-country support, multilingual AI content, currency rules, and per-country SEO configuration.

🔗
Integrations

GeoDirectory, Kadence, WooCommerce, OpenAI API, and the full list of 10+ compatible themes.

⚙️
Developer & API
New Beta

49 WordPress action & filter hooks, REST API endpoints, custom module development guide.

🛠️
Troubleshooting

Common errors, debug mode, conflict resolution, performance tuning, and full error code reference.

All 13 industry presets

Jump straight to your industry

Each preset pre-configures fields, SEO rules, AI prompts, and content templates for your specific niche.

40+ modules

Complete module reference

Every module in AddiPress Pro — what it does, how to configure it, and what plan it requires.

For developers

Extend & customise

49 action & filter hooks give you complete control over every AddiPress behaviour.

🪝

Action Hooks

Fire custom code at key points in the AddiPress lifecycle — before/after AI runs, on listing save, on ranking update.

// Run custom code after AI generates content add_action( 'addipress_after_ai_generate', function( $listing_id, $content ) { // your code here }, 10, 2 );
View all 32 action hooks →
🔧

Filter Hooks

Modify AI prompts, SEO output, content templates, and module behaviour before they take effect.

// Modify the AI prompt for listing descriptions add_filter( 'addipress_listing_prompt', function( $prompt, $listing ) { $prompt .= ' Always mention pricing.'; return $prompt; }, 10, 2 );
View all 17 filter hooks →
🌐

REST API

Programmatic access to modules, listings, AI results, and analytics via authenticated REST endpoints.

GET /wp-json/addipress/v1/modules GET /wp-json/addipress/v1/analytics POST /wp-json/addipress/v1/runner/trigger GET /wp-json/addipress/v1/serp/rankings
REST API reference →
📦

Custom Modules

Build your own AddiPress module using the Module SDK — register it in the dashboard like any built-in module.

// Register a custom module AddiPress::register_module([ 'id' => 'my-module', 'label' => 'My Module', 'callback' => 'my_module_run', ]);
Module SDK docs →
Troubleshooting

Common issues & fixes

Most issues are solved in under 2 minutes. Check these first before opening a support ticket.

Plugin activated but no AddiPress menu appears in wp-admin
This usually means the licence key hasn't been activated yet, or GeoDirectory isn't installed. Go to Plugins → AddiPress, click Settings, and enter your licence key. Then ensure GeoDirectory is installed and activated — AddiPress requires it as a base layer.
AI modules show "API Error" or content isn't generating
Check your OpenAI API key under AddiPress → Settings → AI Config. Ensure the key has sufficient credits and that your server can make outbound HTTPS requests. Some managed hosting providers block outbound calls — add api.openai.com to your firewall allowlist.
SERP Sniper rankings aren't updating
SERP Sniper uses your WordPress cron to schedule rank checks. If your site uses a managed host with disabled WP-Cron, set up a real server cron that calls wp-cron.php every 15 minutes. You can also trigger a manual rank check from AddiPress → SERP Sniper → Force Refresh.
Industry preset applied but fields didn't change
After applying a preset, go to GeoDirectory → Custom Fields and click Sync Fields. Some hosting environments with aggressive object caching may delay the field sync — clear your site cache after applying any preset.
B2B Hunter finds no leads / returns empty results
B2B Hunter requires at least 10 active listings in your directory to build its lead model. Ensure your listings have complete business names and locations. The first scan may take up to 24 hours to process depending on directory size.
Site slows down after activating AddiPress
By default, AI modules run asynchronously in the background and shouldn't affect frontend performance. If you notice slowdowns, go to AddiPress → Settings → Performance and enable Background Queue Mode. This offloads all AI processing to scheduled cron tasks.
Localization not showing correct language / currency
Go to AddiPress → Settings → Localization and confirm your country is set correctly. Localization uses the WordPress site language as a fallback — make sure Settings → General → Site Language matches your target country. For multi-language setups with WPML or Polylang, see the WPML integration guide.
We're here to help

Get support

🎫
⚡ Avg. reply: 4 hours

Support Ticket

Describe your issue in detail and our team will investigate. Includes screen recordings and log file analysis.

Open a ticket →
✉️
Business hours

Email Support

Send your question directly to our support team. Ideal for licence issues, billing questions, and account management.

support@addipress.com
📚
Always available

Changelog & Updates

Track every change, new module, and bug fix. Updated with every release — subscribe for email notifications.

View changelog →

Still have questions?
We've got you.

Our support team replies within 4 hours on business days. Or jump straight to a 1-on-1 onboarding call — included free with every Agency licence.