Descrição
Hreflang Customizer is a free plugin that generates hreflang tags for your WordPress pages automatically. It works on any site — no multilingual plugin is required.
Hreflang tags tell search engines which language and region each page targets. This prevents duplicate-content issues across multilingual or multi-regional sites and helps the right version of your page rank in the right country.
Key Features
- ✅ Works without any translation plugin — standalone mode out of the box
- ✅ Also integrates with Weglot for translated URL mapping
- ✅ Searchable language picker with 180+ languages and regional variants
- ✅ Selected languages shown as removable tag chips with language codes
- ✅ Language list cached via WordPress Transients API (no repeated API calls)
- ✅ Clean, modern admin UI — fully responsive
- ✅ No upsells, no premium tier — 100% free
How It Works
Standalone mode: Select your target language codes in the settings page. The plugin outputs one <link rel="alternate" hreflang="..."> tag per selected code in the <head> of every page, pointing to the canonical URL of that page.
Weglot mode: If Weglot is installed and active, the plugin maps Weglot’s translated URLs to your selected hreflang codes automatically.
Example Output
<link rel="alternate" href="https://yoursite.com/about/" hreflang="en-AU" />
<link rel="alternate" href="https://yoursite.com/about/" hreflang="en-GB" />
<link rel="alternate" href="https://yoursite.com/" hreflang="x-default" />
Third-Party Service
This plugin optionally fetches an extended language list from https://app.seo-hreflang.com/api/languages to supplement its built-in language database. The request is made at most once every 12 hours. No personal data, user data, or site content is transmitted — the request contains no body payload. The result is cached locally using the WordPress Transients API.
If the external service is unavailable, the plugin automatically falls back to its built-in list of 180+ languages and continues to work normally.
- Service URL: https://app.seo-hreflang.com/
- Privacy Policy: https://seo-hreflang.com/privacy-policy/
Capturas de tela
Instalação
- In your WordPress dashboard, go to Plugins > Add New
- Search for Hreflang Customizer
- Click Install Now, then Activate
- Go to Hreflang > Settings and select your target languages
- Click Save Languages — hreflang tags will appear in your site’s
<head>immediately
Alternatively, download the zip and upload via Plugins > Add New > Upload Plugin.
Perguntas frequentes
-
Do I need a translation plugin?
-
No. The plugin works standalone. It outputs hreflang tags pointing to your current page URLs. If you also use Weglot, it will automatically map Weglot’s translated URLs instead.
-
Which translation plugins are supported?
-
Currently Weglot is fully supported in addition to standalone mode. Support for WPML, TranslatePress and Polylang is planned for a future release.
-
What is x-default?
-
x-default is a special hreflang value that tells Google which page to show when no other language matches the user’s browser language. When selected, it points to your site’s home URL.
-
Does the plugin make external requests?
-
Yes, optionally. It requests a language list from https://app.seo-hreflang.com/api/languages and caches the result for 12 hours. If the server is unreachable, the built-in language list is used. No user or site data is sent.
-
What are the minimum requirements?
-
WordPress 5.8 or higher and PHP 5.6.20 or higher.
Avaliações
Colaboradores e desenvolvedores
“Hreflang Customizer” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresTraduzir o “Hreflang Customizer” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
1.1.0
- Plugin is now fully free — no premium tier
- Added standalone mode: hreflang tags work without any translation plugin
- Added Weglot integration for translated URL mapping
- Completely redesigned admin UI with searchable language grid
- Language codes now shown as badge chips on selected tags
- Built-in static language fallback (180+ languages) when API is unavailable
- Added “Buy me a coffee” donate link
- Fixed: CSS/JS now loads reliably on all server configurations
- Fixed: all WordPress.org security requirements (sanitize, escape, validate)
- Removed: premium/pro version references
- Removed: Select2 dependency
1.0.0
- Initial release.


