Docs / Installation & Setup

Installation & Setup

Get Serpelo up and running on your WordPress site in under 5 minutes.

Installation

Method 1: WordPress Admin Upload

Download the Plugin

Download serpelo-pro.zip from your WebTown account or the purchase confirmation email.

Upload via WordPress

Go to Plugins β†’ Add New β†’ Upload Plugin. Choose the ZIP file and click Install Now.

Activate

Click Activate Plugin. Serpelo will automatically set up everything it needs and configure default settings.

πŸ–ΌοΈ
WordPress Plugin Upload Screen
Screenshot: Plugins β†’ Add New β†’ Upload Plugin β€” 800 Γ— 400px β€” assets/images/install-upload.png

Method 2: FTP / File Manager

Extract the ZIP

Unzip serpelo-pro.zip on your computer. You'll get a serpelo-pro folder.

Upload to wp-content/plugins/

Connect via FTP or your host's File Manager. Upload the serpelo-pro folder to /wp-content/plugins/.

Activate in WordPress

Go to Plugins in your WordPress admin. Find "Serpelo" and click Activate.

πŸ’‘
Auto-Setup: On first activation, Serpelo automatically configures default settings and schedules background monitoring tasks. No manual database setup required.

What Happens on Activation

When you first activate Serpelo, it automatically handles the following setup:

ActionDescription
Default SettingsEnables recommended defaults: sitemaps on, schema on, Open Graph on, breadcrumbs on, 404 monitoring on, image optimization on, and more.
Background MonitoringSchedules automated tasks: daily site health audit, weekly email reports, hourly uptime checks, keyword rank tracking, and content freshness monitoring.
License StatusSets your tier to Free until you activate a Pro or Elite license key.
SEO URLsSets up your XML sitemap and AMP URLs to work automatically.

License Activation

Navigate to the License Page

Go to Serpelo β†’ License in your WordPress admin sidebar.

Enter Your License Key

Paste your license key in the input field. License keys follow these formats:

  • Pro: SERPELO-PRO-XXXX-XXXX-XXXX
  • Elite: SERPELO-SP-XXXX-XXXX-XXXX

Click Activate

The plugin validates your key against the Serpelo license server. On success, your tier is upgraded and your AI token balance is synced.

πŸ–ΌοΈ
License Activation Page
Screenshot: License page with key input and tier badges β€” 800 Γ— 450px β€” assets/images/license-activate.png
⚠️
Offline Fallback: If the license server is unreachable, Pro/Elite keys matching the standard format are activated offline with a +1 year default expiry. Test keys always require online validation.

Setup Wizard

After activation, the Setup Wizard walks you through essential configuration. It appears automatically on first install. For a detailed walkthrough of every step, see the dedicated Setup Wizard guide.

πŸ–ΌοΈ
Setup Wizard Step 1 β€” Basic Configuration
Screenshot of the Setup Wizard β€” 800 Γ— 500px β€” assets/images/setup-wizard.png

Wizard Steps

StepConfigurationOptions
1. Basics Title separator, homepage title & description Separator choices: |, -, –, Β·, Β». Supports {site_name} and {site_desc} placeholders.
2. Features Toggle core modules Sitemaps, Schema, Open Graph, Breadcrumbs, Redirects, 404 Monitor, Image Optimization
3. Schema Organization / Person type, name, logo, URL Used for site-wide Organization/Person schema on homepage
4. Image Settings Quality, max width, WebP, lazy loading Quality: 1-100 (default 82), Max width: px (default 1920)
5. Monitoring Periodic monitor email, frequency Weekly/Daily/Monthly frequency, recipient email

Running Your First Audit

After setup, visit the Dashboard to see your overall SEO health score and identify quick wins.

Go to Dashboard

Navigate to Serpelo β†’ Dashboard. You'll see the main dashboard with gradient stat cards, SEO score ring, and quick action buttons.

Run Site Health Audit

Click the Run Health Audit button. The audit checks on-page factors, schema coverage, sitemap status, image optimization, broken links, and more.

Review Issues & Fix

The audit surfaces issues ranked by severity. Use the Quick Fix buttons or navigate to the relevant feature page for detailed management.

πŸ–ΌοΈ
Dashboard β€” After First Audit
Screenshot: Dashboard with health score, stat cards, quick actions β€” 1000 Γ— 600px β€” assets/images/dashboard-first-audit.png

Migration from Other SEO Plugins

Serpelo includes a built-in importer that detects and migrates data from popular SEO plugins.

βœ…
Supported Imports: Yoast SEO, Rank Math, All in One SEO Pack, SEOPress, and The SEO Framework. Migrates titles, descriptions, focus keywords, social meta, redirects, and schema mappings.

Import Process

Navigate to Import

Go to Serpelo β†’ Settings β†’ Import SEO Data.

Select Source Plugin

The importer auto-detects installed SEO plugins. Select the one you want to migrate from.

Preview & Import

Click Preview Import to see what data will be imported. Review the summary, then click Import Data to begin the migration.

Rollback (if needed)

If anything goes wrong, use the Rollback button to undo the import and restore your previous data.

⚠️
Important: Keep your old SEO plugin installed (but deactivated) until you've verified the import. This ensures the source data remains available for re-import if needed.