---
title: "Documentation - Setup, API, and Guides - PerfLocale"
description: "Guides, references, and API documentation for PerfLocale - the performance-first multilingual plugin for WordPress."
canonical: "https://perflocale.com/docs/"
source: "https://perflocale.com/docs/"
format: "markdown"
---
# Documentation

Guides, references, and API documentation for PerfLocale

## Getting Started

The basics - translate content, pick a URL layout, drop in a language switcher.

[**Getting Started Guide**Step-by-step from activation to a fully translated post in 15 minutes.](getting-started/) [**Content Translation**Translate posts, pages, and custom post types.](content-translation/) [**String Translation**Translate gettext strings from themes and plugins.](string-translation/) [**URL & Routing**Pick subdirectory, subdomain, domain, or query-parameter structure.](url-routing/) [**Language Switcher**Block, shortcode, widget, and template tags.](language-switcher/) [**Translations Admin**The admin page that shows what's done and what isn't.](translations/) [**Shortcodes**Full shortcode reference.](shortcodes/)

## Production Tuning

Get a production-ready setup - caches, CDN, and database sizing.

[**Production Tuning Guide**The complete walkthrough, with measured query counts for every change.](production-tuning/) [**Background Jobs**How long-running operations move off the request path. Settings, recovery, CLI, REST.](background-jobs/) [**Reliability & Circuit Breakers**Operator's guide to breakers, locks, Site Health checks, and data retention.](reliability/) [**CDN Cache-Tag Headers**Per-language CDN purge tags.](cache-tags/) [**Edge Integration**Cloudflare Workers, Vercel & Netlify Edge routing.](edge-integration/) [**Exchange Rate Sync**Daily multi-currency rate refresh.](exchange-rates/)

## Developer API

Hooks, REST endpoints, WP-CLI, and the addon contract.

[**Developer API Overview**Build on top of PerfLocale.](developer-api/) [**Addon System**Schema & uninstall contracts for custom integrations.](addon-system/) [**Hooks Reference**200+ actions and filters.](hooks/) [**REST API**Full endpoint documentation.](rest-api/) [**WP-CLI Commands**Command-line tools for automation.](wp-cli/) [**Helper API**Fluent PHP helper functions for templates.](helper-api/) [**API Keys (env / constant / DB)**Resolve secrets from env vars first, then wp-config.php constants, then admin settings.](api-key-constants/)

## Integrations & Features

WooCommerce, machine translation, SEO, and more.

[**WooCommerce Guide**Product translation and multi-currency.](woocommerce/) [**Machine Translation**DeepL, Google, Microsoft, LibreTranslate.](machine-translation/) [**SEO**Hreflang, sitemap, and SEO plugin integration.](seo/) [**SEO Schema Enrichment**JSON-LD inLanguage + translation cross-links.](seo-schema/) [**GeoIP Redirect**Auto-redirect visitors by country or browser language.](geo-redirect/) [**Conditional Content**Show content by language - block, shortcode, PHP.](conditional-content/) [**Language Fallbacks**What to show when a translation is missing.](language-fallbacks/) [**Bundled Addons**Every theme, page builder, and SEO plugin we support.](addons/)

## Operations & Migration

Permissions, data export/import, migration from other plugins, and privacy.

[**Permissions & Roles**User capabilities and the translator role.](permissions/) [**Export & Import**XLIFF and JSON for external translators.](export-import/) [**Migration**Move from WPML, Polylang, or TranslatePress.](migration/) [**Privacy**What data the plugin stores, GDPR compliance.](privacy/) [**Multisite**Network installs, per-site languages, and URL modes.](multisite/) [**Troubleshooting**Site Health warnings and what to do about them.](troubleshooting/)