OneClickSEO Documentation

v1.6.2

Complete guide to optimize your WordPress site with AI-powered SEO tools

Overview

OneClickSEO is a powerful WordPress plugin that leverages GPT-5 artificial intelligence to automate and optimize your site's SEO. From meta tag generation to schema markup, sitemap creation to content analysis, OneClickSEO handles everything with a single click.

SEO Health Score

Comprehensive 0-100 scoring system with 4 key components to track your site's SEO performance.

AI-Powered

Uses GPT-5 with 3 model options (gpt-5.2, gpt-5-mini, gpt-5-nano) for intelligent optimization.

6 Site Presets

Quick configuration for Blog, E-commerce, Local Business, Portfolio, Corporate, or Custom sites.

API Key Required

A valid OpenAI API key is required for all AI-powered features. Get yours at platform.openai.com.

System Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • Elementor 3.0+ for Elementor integration features
  • Valid OpenAI API key from platform.openai.com
  • WooCommerce 5.0+ for e-commerce features (Pro)
  • WPML or Polylang for multilingual support (Pro)

Installation

Quick Start (2 minutes)

  1. Upload the plugin Go to Plugins > Add New > Upload Plugin in your WordPress admin
  2. Activate the plugin Click "Activate" after installation completes
  3. Complete the onboarding wizard Follow the 5-step guided setup to configure your settings
  4. View your Health Score Check your SEO Dashboard to see your initial score
  5. Start optimizing Use one-click AI generation to optimize your content

Site Type Presets

During setup, choose the preset that matches your site:

Preset Schema Type Best For
Blog / Publisher BlogPosting Content-focused sites, news, magazines
E-commerce Product Online stores, WooCommerce sites
Local Business LocalBusiness Physical locations, service areas
Portfolio / Agency WebPage Creative work, design portfolios
Corporate / Enterprise Organization Large organizations, brand sites
Custom User-defined Advanced users, specific needs

SEO Dashboard

Health Score System

The Health Score provides a comprehensive 0-100 point rating of your site's SEO performance, calculated from four key components:

75
Optimization Coverage 30 pts
Technical Health 40 pts
404 Errors 15 pts
Configuration Status 15 pts

Dashboard Components

Free Features 16 Features

AI-Powered Optimization

  • AI Meta Generation: Generate SEO-optimized titles and descriptions using GPT-5
  • Model Selection: Choose between 3 AI models:
    • gpt-5.2 - Most powerful, best for complex analysis
    • gpt-5-mini - Balanced performance and speed
    • gpt-5-nano - Fastest, ideal for bulk operations
  • Site Analysis: AI-powered evaluation of your overall SEO performance

Technical SEO

  • XML Sitemap: Auto-generated sitemap with configurable content types and automatic search engine pinging
  • Schema Markup: 14 structured data types supported:
    • Article, BlogPosting, NewsArticle, WebPage
    • Product, LocalBusiness, Organization, Person
    • FAQPage, HowTo, Event, Recipe, Review, BreadcrumbList
  • Auto Schema Detection: Intelligent content analysis for automatic schema selection
  • 404 Monitoring: Track broken links with hit counters and bot filtering

Editor Integrations

  • Elementor: Native SEO panel directly in the Elementor editor with one-click optimization
  • Gutenberg: Dedicated SEO sidebar for the block editor
  • Classic Editor: SEO controls via meta box on every post and page

Configuration

  • Site Type Presets: 6 quick configurations for different site types
  • Onboarding Wizard: 5-step guided setup with API validation
  • Built-in Cache: WordPress transient-based caching with zero frontend impact

Pro Features Pro

URL & Redirect Management

  • Redirections Manager: Create and manage 301/302/307 redirects with smart URL suggestions and hit tracking
  • Advanced 404 Management: Mark errors as resolved, create redirects from 404s, export error logs

Google Search Console Analytics

  • Performance Metrics: Track clicks, impressions, CTR, and keyword positions
  • Period Comparison: Compare data across 7 days, 28 days, or 3 months
  • Top Pages & Keywords: See your best performing content and search terms

Comprehensive SEO Audit

Full site audit with 7 categories and 47+ checks:

Category Checks
Meta Tags Title/description length, H1 presence, Open Graph tags
Images Alt text, file size, WebP format, descriptive filenames
Links Broken internal links, redirect chains, orphan pages
Content Word count, duplicate content, heading structure, readability
Indexation Sitemap inclusion, robots.txt, canonical tags, noindex
Performance Caching signals, image optimization, page load indicators
Security HTTPS usage, mixed content, WordPress version exposure
  • Batch Processing: Audit large sites with 50-item batches and progress tracking
  • Issue Tracking: Error/Warning/Info classification with resolution tracking
  • CSV Export: Export audit results for external analysis

E-commerce & Multilingual

  • WooCommerce SEO: Product schema markup, automatic meta generation, category SEO fields, Open Graph tags
  • WPML Integration: Automatic hreflang tags and language-specific SEO metadata
  • Polylang Integration: Multilingual sitemaps with XHTML links for language alternatives

Advanced Features

  • Bulk Optimization: Optimize multiple pages at once with batch processing and progress modal
  • Priority Support: Dedicated assistance with faster response times
Upgrade to Pro

Configuration

API Settings

  • OpenAI API Key: Enter your valid API key from platform.openai.com
  • Model Selection: Choose between gpt-5.2 (quality), gpt-5-mini (balanced), or gpt-5-nano (speed)
  • API Validation: Test your API key to ensure it's working correctly

Optimization Settings

  • Content Types: Select which post types (pages, posts, products, custom) to optimize
  • Schema Generation: Enable automatic schema markup for better search results
  • Heading Optimization: Automatically reorganize headings for better SEO
  • Image Optimization: Generate alt text and optimize image metadata
  • Sitemap Settings: Configure which content types to include in your sitemap

Site Identity

  • Site Description: Define your site's main purpose and offerings
  • Site Objective: Set clear goals for your website's SEO
  • Target Audience: Specify who your content is designed for
Tip

Start with default settings and adjust based on your specific needs. Use the site presets for quick configuration.

Usage Guide

Global Site Optimization

  1. Navigate to Optimization Go to OneClick SEO > Optimization in WordPress admin
  2. Configure options Select which elements to optimize: meta tags, schema, headings, images, sitemap
  3. Start optimization Click "Optimize entire site" to begin the process
  4. Monitor progress Watch real-time progress and review results when complete

Individual Page Optimization

  1. Open your page Edit in WordPress, Elementor, or Gutenberg editor
  2. Locate the SEO panel Find the OneClick SEO metabox or tab in your editor
  3. Set page context Define page objective and target audience for better results
  4. Optimize Click "Optimize this page" and review AI suggestions

Working with the Sitemap

  1. Navigate to OneClick SEO > Optimization
  2. Enable "Generate sitemap" option
  3. Click "Generate sitemap" or include it in global optimization
  4. Sitemap will be available at /wp-content/uploads/sitemaps/sitemap.xml
  5. Google and Bing are automatically notified

Managing API Usage

Optimize your OpenAI API costs:

  • Use gpt-5-nano for bulk operations
  • Use gpt-5.2 for important pages only
  • Optimize new or changed content, not the entire site repeatedly
  • Focus on high-priority pages first

External Services

OpenAI API

  • Purpose: Powers AI-driven analysis and optimization
  • Data transmitted: Page content, titles, and descriptions
  • When: Only when you request analysis or optimization
  • Privacy: Privacy Policy | Terms of Service

Google Search Console API

  • Purpose: Sitemap notifications and analytics data (Pro)
  • Data transmitted: Sitemap URL; OAuth for analytics access
  • When: Sitemap generation; Analytics tab access
  • Privacy: Privacy Policy | Terms of Service

Bing Webmaster Tools

  • Purpose: Sitemap notifications for better indexing
  • Data transmitted: Sitemap URL
  • When: Only when sitemap is generated
  • Privacy: Privacy Policy | Terms of Service
Security

All data is transmitted securely via HTTPS. No personal data is stored externally or shared without consent.

Troubleshooting

Common Issues

API Key Not Working
  • Verify your API key is correct at platform.openai.com
  • Check that you have available API credits
  • Ensure the key has not expired or been revoked
  • Use the "Validate API Key" button in settings to test
Optimization Stops or Fails
  • Check for PHP timeout issues (increase max_execution_time)
  • Verify you haven't hit OpenAI rate limits
  • Try optimizing fewer pages at once
  • Check server error logs for details
Sitemap Not Generating
  • Verify write permissions to /wp-content/uploads/
  • Check that the uploads directory exists
  • Ensure no security plugins are blocking file creation
  • Try generating manually from the Optimization tab
Elementor Integration Issues
  • Confirm you're using Elementor 3.0 or higher
  • Clear Elementor cache and regenerate CSS
  • Deactivate other SEO plugins that might conflict
  • Check browser console for JavaScript errors

Error Messages

  • "Invalid API Key": Your OpenAI API key is incorrect or has expired
  • "API Rate Limit Exceeded": Wait and try again, or upgrade your OpenAI plan
  • "Unable to save sitemap file": Server permission issue with uploads directory
  • "Connection timeout": Server or network issue, check hosting configuration

Best Practices

  • Always provide a clear page objective and target audience for better optimization
  • Review AI-generated suggestions before applying them
  • Optimize your most important pages first
  • Use internal linking suggestions to strengthen your site structure
  • Regularly update your content and re-optimize as needed
  • Monitor your search rankings after optimization to track improvements
  • Keep your Health Score above 80 for optimal performance
Important

While OneClickSEO provides powerful AI-driven optimization, human review and editing are still important for the best results. Always verify AI suggestions before publishing.