Plugin

AutoPilot WP Guide

AutoPilot WP user manual

Learn what each AutoPilot WP section is for, when to use it, and how the main workflows fit together. This manual follows the same structure as the plugin sidebar.

01

Workspace

Workspace Dashboard

The workspace is the daily overview area. Use it to understand what AutoPilot WP has recently created, imported, shared, queued, or logged.

  1. Open AutoPilot WP from the WordPress admin sidebar to see the main dashboard.
  2. Review the overview cards to understand connected accounts, recent publishing activity, campaign success, AI cost, and queue health.
  3. Use Recent Social Activity to quickly see the latest successful or failed social delivery attempts.
  4. Use Background Queue Health to spot pending, processing, failed, or unread system notices before running larger automation tasks.

Dashboard

The central overview for the plugin. It summarizes connected accounts, current publishing activity, AI cost, campaign success, recent social logs, and queue health.

  • Use it first after login to understand the current state of the plugin.
  • Recent Social Activity reflects manual publisher sends, auto-posts, category mapping sends, and re-share schedules.
  • Background Queue Health shows whether automation jobs are waiting, processing, failed, or paused.

Recommended Daily Flow

The workspace dashboard is not where you configure everything; it is where you review the overall system before and after daily automation work.

  • Review the dashboard before running large imports, queue batches, or social schedules.
  • Return to Dashboard after major automation work to review cards, logs, and queue state.
  • Any unexpected failure should be traced from the relevant Logs screen, not guessed from the dashboard alone.
02

AI Suite

AI Content Creation

The AI Suite helps you create article drafts, social captions, image prompts, reusable prompts, and recurring AI content schedules.

  1. Start in AI Settings and save at least one provider key, default model, tone, language, and post status.
  2. Use AI Writer for one-off article packages, social caption sets, or featured image generation.
  3. Use Prompt Templates when you want consistent article, caption, or image prompt structures across many runs.
  4. Use Generated Queue when you want to create many articles from multiple keywords or schedule recurring topic generation.
  5. Keep WordPress post status set to Draft until you are comfortable with the generated output quality.

AI Writer

Creates one-off article packages, social caption sets, and featured image outputs from a topic or brief.

  • Article Package should return title, summary, outline, FAQs, meta description, article body, and featured image prompt.
  • Use Draft status while reviewing generated content before allowing posts to publish.
  • SEO mode should be used for keyword-focused blog posts and buying guides.

Prompt Templates

Stores reusable article, caption, image, and custom prompts so every run can follow the same content style.

  • Start from the built-in templates, then create custom prompts when a site needs a specific voice or structure.
  • Use placeholders like keyword, tone, language, word count, text, and networks to make templates reusable.
  • After saving a template, return to AI Writer and select it from the template dropdown.

AI Settings

Stores provider keys, default models, language, tone, post defaults, SEO defaults, and featured image defaults.

  • You only need one valid provider key to begin using the AI Suite.
  • Use the provider connection check before using a provider in AI Writer or queue jobs.
  • Saved defaults are used when another screen says Use saved default.

Generated Queue

Runs multiple article jobs in the background and supports recurring topic schedules for auto-blog workflows.

  • Queue two or three keywords first, not a large batch.
  • Watch statuses move from pending to processing to completed.
  • Recurring schedules are safest when they start with Draft output before being switched to published output.
03

Content Import

Content Import Engine

Content Import pulls content from feeds, news sources, social/video sources, APIs, and websites, then turns that content into WordPress posts.

  1. Use Feed Sources to understand which source type fits your content source before building a campaign.
  2. Create an Import Campaign by choosing the source, schedule, post status, duplicate rules, source metadata, and cleanup behavior.
  3. Use Scraper Rules when full-text extraction or website selectors are needed for cleaner imported content.
  4. Use Import Logs to review what was imported, skipped, rewritten, or failed for every campaign run.
  5. Use draft output for new sources until you know the imported titles, content, images, categories, and tags look correct.

Import Campaigns

Creates cron-driven campaigns that import from RSS, Google News, YouTube, Reddit, Facebook Pages, generic websites, and other connectors.

  • Use draft post status and a low max post count when adding a new source.
  • Keep duplicate title detection enabled for aggregation sources.
  • Run the campaign manually once before relying on cron automation.
  • Enable AI rewrite only after raw importing works.

Feed Sources

Explains supported source types, required fields, and which sources support full-text extraction or scraper selectors.

  • Use this page as the reference before creating campaign fields.
  • RSS is the easiest first source because it usually requires only a feed URL.
  • API-based sources require real API keys or tokens.

Scraper Rules

Reviews extraction selectors, duplicate protection, metadata capture, and cleanup rules behind campaigns.

  • Selectors are needed when the source does not provide clean feed content.
  • Use stable selectors such as article, .entry-content, time, .author-name, and tag/category links.
  • If imported content is partial, revisit full-text settings and selectors.

Import Logs

Shows imported, skipped, failed, and rewritten records so users can understand campaign history.

  • Imported records should include a post link.
  • Skipped duplicate records mean the plugin found an existing WordPress title and avoided importing it again.
  • Source fetch errors should be visible when credentials or APIs fail.
04

Social Publishing

Social Publishing and Scheduling

Social Publishing sends posts and messages to connected social accounts, account groups, mapped categories, and evergreen re-share schedules.

  1. Use Accounts to connect and organize the social destinations you want AutoPilot WP to use.
  2. Use Publisher to send manual messages, links, images, videos, or selected WordPress posts to individual accounts or groups.
  3. Use Groups to bundle multiple accounts by brand, client, website, or campaign.
  4. Use Category Mapping to automatically route WordPress categories to specific accounts or groups.
  5. Use Post Scheduler to re-share older evergreen WordPress posts on a repeating interval.
  6. Use Logs to review delivery status, live links, skipped items, and platform-specific errors.

Publisher

Sends immediate or queued social posts to selected accounts or account groups.

  • Text posts are safe for Discord, but Instagram requires an image, video, or story asset.
  • Start with one account first, then expand to multiple accounts or groups.
  • Check Logs after every send, even when the destination appears successful.

Accounts

Connects, checks, removes, labels, organizes, and restricts social accounts.

  • Use the account health action for each account after saving credentials.
  • Use Organize to assign labels, visibility, roles, notes, and groups.
  • Inactive accounts should not be available for posting.

Groups

Bundles accounts by client, brand, website, or campaign so one selection can target many destinations.

  • Add Discord, Facebook, and Instagram to one group only after each account is configured individually.
  • Publisher group sends should create separate log records for each account.
  • Deleting a group should persist after refresh and should not delete the accounts themselves.

Category Mapping

Routes WordPress categories to default social accounts or groups for auto-share behavior.

  • Map one category to one safe account first.
  • When a post in that category is published, AutoPilot WP uses the mapping to select the destination.
  • Use groups when one category should publish to several social channels.

Post Scheduler and Logs

Creates evergreen re-share schedules and records every delivery attempt.

  • Create low-frequency schedules first so older posts are re-shared at a controlled pace.
  • Use Refresh to reload logs, Delete Selected for checked rows, Clear Old Logs for aged records, and Clear Matching only after filters are correct.
  • Log cleanup should never remove records outside the selected or filtered scope.
05

Commerce and Affiliate

Commerce and Affiliate Workflows

Commerce and Affiliate helps you import monetizable products, maintain affiliate links, refresh prices, and sync products into WooCommerce when available.

  1. Use Affiliate Sources to understand available product networks and what credentials each one needs.
  2. Use Product Campaigns to search and import products from Amazon, eBay, AliExpress, or ClickBank using filters such as keyword, price, category, condition, and commission.
  3. Use WooCommerce Imports to review affiliate links, copy cloaked URLs, copy shortcodes, refresh prices, and sync active links as WooCommerce external products.
  4. Use Product Logs to understand product campaign results, duplicate skips, and source request errors.
  5. Install and activate WooCommerce before expecting WooCommerce product sync features to be available.

Affiliate Sources

Introduces Amazon, eBay, AliExpress, and ClickBank connectors and explains which support images, prices, WooCommerce sync, and product filters.

  • This is a reference page, not the place where products are imported.
  • Real imports require valid source credentials from the relevant affiliate network.
  • Use it to understand required setup before creating Product Campaigns.

Product Campaigns

Creates product import campaigns with source-specific filters such as keyword, price, marketplace, condition, category, commission, manufacturer, and sales rank.

  • Without real credentials, product sources cannot import real marketplace data.
  • Keep max posts low when adding a new product campaign.
  • Product Logs should show imported, skipped, or source fetch failed results.

WooCommerce Imports

Turns active affiliate links into WooCommerce external or affiliate products when WooCommerce is installed and product data exists.

  • WooCommerce must be active for product sync.
  • Synced products should include title, price, image, description, brand/source data, and outbound affiliate URL.
  • The Links tab can still provide cloaked URLs and shortcodes even before WooCommerce sync.

Product Logs

Records product campaign runs, successful imports, duplicate skips, and failed source requests.

  • An empty log is normal before a product campaign has run.
  • Credential problems should appear as readable source errors.
  • Use logs to prove the product importer fails safely when APIs are unavailable.
06

Growth and Insights

Growth, Reporting, and Optimization

Growth and Insights helps you measure activity, collect newsletter subscribers, improve content quality, and prepare reports for review.

  1. Use Analytics & Reports to review traffic, social performance, campaign activity, AI usage, and affiliate ROI across selected date ranges.
  2. Use Newsletter to collect local subscribers or sync subscribers to supported email providers when credentials are configured.
  3. Use Content Optimizer to review readability, keyword density, metadata, duplicate risk, internal links, rewrite options, spinning, and translation readiness.
  4. Use CSV or PDF exports when you need a shareable report for a client, owner, or internal review.
  5. Remember that report cards show zero until the plugin has real activity in the selected date range.

Analytics and Reports

Displays overview, traffic, social, campaign, AI usage, and affiliate ROI reports over 7, 30, and 90 day windows.

  • Zero values are normal until real activity exists.
  • AI Usage should update after AI Writer, queue, rewrite, caption, or image actions.
  • CSV/PDF export is for client-ready reporting where supported by the environment.

Newsletter

Captures local subscribers and can sync to external providers when credentials are configured.

  • Local list works without a third-party provider.
  • Save Settings should return success and persist form title, description, button, tags, and double opt-in state.
  • Use [apwp_newsletter_form] to show the form on a frontend page.

Content Optimizer

Reviews readability, keyword density, metadata, duplicate risk, keyword suggestions, internal links, AI rewrite, spin, and translation readiness.

  • Optimize tab does not require an AI key for basic scoring.
  • Rewrite requires a configured AI provider.
  • Translation requires Google, DeepL, or Microsoft translation credentials; otherwise it may return unchanged text.
07

Configuration

Settings and Enterprise Configuration

Configuration controls provider keys, publishing defaults, importer credentials, affiliate credentials, white-label settings, permissions, teams, clients, queues, and API access.

  1. Use Settings for normal site-level defaults such as AI providers, translation keys, social behavior, importer credentials, and affiliate credentials.
  2. Use Enterprise when the site needs agency features such as white-label branding, teams, clients, role permissions, multisite behavior, queue tuning, proxies, or external API keys.
  3. Keep credentials scoped to the services you actually use instead of filling every provider at once.
  4. Use role permissions to give users only the AutoPilot WP areas they need for their work.
  5. Use API access only when a trusted external system needs to interact with the plugin.

Settings

Controls general publishing behavior, AI provider defaults, translation keys, social automation, importer credentials, and affiliate credentials.

  • General settings include Share on Publish, Keep Logs, post interval, and cron secret.
  • Social settings control pause state, auto post, background posting, unique URLs, and default accounts.
  • Importer and Affiliate settings store source credentials used by campaigns.

Enterprise

Supports agencies, multisite installs, teams, clients, white-label branding, queue tuning, permissions, and scoped API keys.

  • White-label app name, menu label, tagline, and support details should persist after save and refresh.
  • Queue defaults control worker behavior, stale job recovery, cleanup windows, and retry timing.
  • Permissions and API keys should be scoped carefully instead of granting broad access.