Docs / Settings Reference

Settings Reference

Complete reference of every configurable option in Serpelo — organized by settings group with option keys, defaults, and descriptions.

On this page
General Settings Performance Image Optimization Auto AI Monitoring Schema Social / Open Graph Robots.txt Local SEO AMP Client Reports Google Search Console Google Analytics Hreflang Email Digest Sitemap Settings Runtime Options WP-Cron Schedules
💡
Saving Settings: All settings are saved automatically when you click Save. The settings page sends the group name and all fields within that group.
🖼️
Settings Page — Main View
Screenshot: Settings page with sidebar tabs and content — 900 × 500px — assets/images/settings-overview.png

General Settings

Group: · Access: Free

Option KeyTypeDefaultDescription
—bool1Enable XML sitemaps generation
—bool1Enable schema/JSON-LD output
—bool1Enable Open Graph and Twitter Card meta tags
—bool1Enable breadcrumb schema markup
—bool1Enable redirect manager
—bool1Enable 404 error monitoring
—bool1Enable automatic image optimization on upload
—bool1Enable periodic site monitoring checks
—string|Character between title parts (e.g., "Post Title | Site Name")
—string{site} | {tagline}Homepage SEO title
—string{tagline}Homepage meta description
—string''Google Search Console verification code
—string''Bing Webmaster Tools verification code
—string''Custom analytics tracking code (head injection)
—bool0Add noindex to date/author archive pages
—bool1Add noindex to tag archive pages

Performance Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—string''Google PageSpeed Insights API key for performance scores
—bool1Show SEO stats in the WordPress admin bar
—stringdailyHow often to refresh stats: 6h, 12h, daily, weekly

Image Optimization Settings

Group: · Access: Free (limits apply)

Option KeyTypeDefaultDescription
—bool1Auto-optimize images on upload
—int82JPEG/WebP compression quality (1-100)
—int1920Maximum width in pixels; larger images auto-resized
—bool1Generate WebP versions of images
—bool1Add lazy loading to images in content

Auto AI Settings

Group: · Access: Elite

Option KeyTypeDefaultDescription
—bool0Master toggle for automatic AI optimization on publish
—bool0Auto-generate SEO title and meta description
—bool0Auto-generate alt text for images in the post
—bool0Auto-insert internal link suggestions

Monitoring Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—bool1Enable periodic monitoring
—email{admin_email}Email address for monitoring notifications
—stringweeklyMonitoring frequency: daily, weekly

Schema Settings

Group: · Access: Free

Option KeyTypeDefaultDescription
—stringOrganizationSite-wide schema type: Organization or Person
—string{site_name}Organization/Person name for schema
—string''Logo URL for Organization schema
—string''Official website URL for schema

Social / Open Graph Settings

Group: · Access: Free

Option KeyTypeDefaultDescription
—string''Default Open Graph image when featured image is missing
—string''Facebook App ID for OG tags
—string''Twitter @username for Twitter Cards
—stringsummary_large_imagesummary or summary_large_image

Robots.txt Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—text''Custom robots.txt content (overwrites WordPress virtual robots)

Local SEO Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—string''Local business name
—string''Business phone number
—string''Business address (full address string)
—string''Latitude,Longitude coordinates

AMP Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—bool0Enable AMP page generation
—array['post']Post types to generate AMP for
—stringreaderAMP mode: reader (separate URL) or native
—string#2271b1AMP template primary color
—string''AMP header logo URL
—string''GA4 measurement ID for AMP pages
—text''Custom CSS injected into AMP pages (max 75KB)

Client Report Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—string''Company name in report header
—string''Logo URL for report header
—string''Primary brand color for reports
—string''Accent color for report highlights
—email''Contact email shown in reports
—string''Contact phone shown in reports
—string''Website URL shown in reports
—text''Custom footer text in reports
—bool0Remove "Powered by Serpelo" branding

Google Search Console Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—string''Google OAuth 2.0 client ID
—string''Google OAuth 2.0 client secret
—string''Verified site URL in Search Console
⚠️
Security: OAuth client secrets are stored encrypted. Never share these values publicly. Use the AJAX action to safely remove credentials.

Google Analytics Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—string''Google OAuth 2.0 client ID for Analytics
—string''Google OAuth 2.0 client secret
—string''GA4 property ID (e.g., properties/123456789)
—string''GA4 measurement ID (e.g., G-XXXXXXXXXX)
—bool0Auto-inject GA4 tracking code in head
—string''Google AdSense publisher ID

Hreflang Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—stringautoauto (detected from WPML/Polylang), manual, or off
—stringenDefault language for x-default hreflang tag

Email Digest Settings

Group: · Access: Pro

Option KeyTypeDefaultDescription
—bool0Enable periodic SEO email digest
—stringweeklydaily or weekly
—email{admin_email}Comma-separated recipient email addresses

Sitemap Settings (Dynamic)

Group: , ,

Per Post Type

PatternTypeDescription
serpelo_sitemap_{$type}boolInclude this post type in sitemap
serpelo_sitemap_priority_{$type}floatPriority value (0.0–1.0)
serpelo_sitemap_freq_{$type}stringChange frequency: daily, weekly, monthly, etc.

Per Taxonomy

PatternTypeDescription
serpelo_sitemap_tax_{$tax}boolInclude this taxonomy in sitemap
serpelo_sitemap_tax_priority_{$tax}floatPriority for taxonomy terms

Advanced

Option KeyTypeDefaultDescription
—bool1Include image entries in sitemap
—string''Comma-separated post IDs to exclude
—int1000Maximum URLs per sitemap file

Runtime Options (Not in Settings UI)

These options are set/read programmatically and don't appear in the settings page.

Option KeyTypeDescription
—intCurrent AI token balance (synced from server)
—intTotal tokens purchased/allocated
—timestampLast token sync time
—stringCurrent DB schema version
—stringIndexables table schema version
—stringActive license key
—stringLicense status: active / expired / inactive
—dateLicense expiration date
—stringCurrent tier: free, pro, elite
—boolContent freshness toggle
—stringreview or auto
—intMax posts to refresh per week
serpelo_img_usage_{Ym}intMonthly image optimization counter (dynamic key)

WP-Cron Schedules

All schedules are registered on plugin activation and cleared on deactivation.

Custom Intervals

SlugIntervalDisplay
—21,600 sec (6 hours)Every 6 Hours (SERPELO)
—43,200 sec (12 hours)Every 12 Hours (SERPELO)

Scheduled Hooks (10 Total)

Hook NameRecurrenceHandler
—dailySERPELO_Site_Health::run_audit() + SERPELO_Periodic_Monitor::run_daily()
—weeklySERPELO_Periodic_Monitor::send_weekly_report()
—hourlySERPELO_Periodic_Monitor::run_hourly()
—weeklySERPELO_Content_Decay::take_snapshot()
—weeklySERPELO_Broken_Links::scheduled_crawl()
—weeklySERPELO_Email_Digest::maybe_send()
—dailySERPELO_Auto_Keyword_Tracker::sync_keywords()
—daily*PageSpeed + GSC sync (batches of 200 posts)
—dailySERPELO_AB_Testing::evaluate_tests()
—weeklySERPELO_AI_Freshness::run_batch()
💡
Stats Refresh: The schedule is dynamically reschedulable via the setting. Options: 6h, 12h, daily, weekly.
← Analytics & Tracking
Next: License & Tiers →