feat(seo): add Learning Center, hreflang, OG tags, and high-value content pages#2024
Merged
Baoyuantop merged 6 commits intomasterfrom Apr 15, 2026
Merged
feat(seo): add Learning Center, hreflang, OG tags, and high-value content pages#2024Baoyuantop merged 6 commits intomasterfrom
Baoyuantop merged 6 commits intomasterfrom
Conversation
…tent pages Technical SEO fixes: - Add global OG meta tags (og:site_name, og:type, og:image) to docusaurus.config.js - Add hreflang plugin for en/zh language alternate links on all pages - Add canonical URL injection via postBuild plugin - Localize Chinese homepage title via i18n translate() - Enhance homepage Head with og:title, og:url, and canonical link Learning Center: - Add new /learning-center/ route via Docusaurus blog plugin - Add "Learning Center" to main navigation bar - Create "What is an API Gateway?" article (~2500 words, targets 10K+ monthly searches) - Create "What is API Management?" article (~2500 words, targets 7K+ monthly searches) AI Gateway page optimization: - Rewrite title for SEO: targets "what is an AI gateway" keyword - Expand meta description with AI gateway definition and MCP support - Add FAQPage structured data (JSON-LD) with 3 AI gateway FAQs - Add canonical URL and og:url
Contributor
There was a problem hiding this comment.
Pull request overview
This PR implements a set of SEO-focused improvements for the APISIX website, including global social meta defaults, locale-aware alternate links, and a new “Learning Center” content section intended to capture high-value educational keywords.
Changes:
- Adds a new
/learning-center/section via an additional Docusaurus blog plugin instance and links it in the main navbar. - Introduces a post-build hreflang/canonical injection plugin and expands OG/Twitter meta defaults.
- Updates homepage and AI Gateway page metadata (title/description/OG/Twitter) and adds FAQPage JSON-LD to
/ai-gateway/.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 9 comments.
Show a summary per file
| File | Description |
|---|---|
| website/src/pages/index.tsx | Localizes homepage <title> and adds canonical/OG/Twitter tags |
| website/src/pages/ai-gateway.tsx | Updates AI Gateway page SEO metadata and adds FAQPage JSON-LD |
| website/learning-center/what-is-api-management.md | Adds a Learning Center article on API management |
| website/learning-center/what-is-an-api-gateway.md | Adds a Learning Center article on API gateways |
| website/i18n/zh/code.json | Adds zh translation for homepage meta title |
| website/docusaurus.config.js | Adds Learning Center blog instance, hreflang plugin, and global OG defaults |
| config/navbar.js | Adds “Learning Center” to top navigation |
| config/hreflang.js | New post-build plugin injecting hreflang + canonical tags |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Baoyuantop
reviewed
Apr 15, 2026
Co-authored-by: Baoyuan <baoyuan.top@gmail.com>
Co-authored-by: Baoyuan <baoyuan.top@gmail.com>
Yilialinn
approved these changes
Apr 15, 2026
Baoyuantop
approved these changes
Apr 15, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
SEO P0 fixes to address critical gaps identified in a comprehensive audit comparing apisix.apache.org vs konghq.com keyword rankings.
Technical SEO
og:site_name,og:type,og:imagetodocusaurus.config.jsfor consistent social sharing previewsconfig/hreflang.jsDocusaurus plugin that injectshreflangalternate links (en/zh/x-default) and canonical URLs into all HTML pages during post-buildtranslate()for proper i18n — Chinese locale renders "Apache APISIX - 开源云原生 API 网关与 AI 网关"og:title,og:url, and canonical linkLearning Center (new section)
/learning-center/route via Docusaurus blog plugin instanceapi gateway(6,600/mo),what is an api gateway(720/mo), and 15+ keyword variants totaling ~10,000+ monthly searches. Currently APISIX ranks update the home page #25-88 for these keywords vs Kong's added languaeg switcher #3-9.api management(1,900/mo),apim(2,400/mo), and 10+ variants totaling ~7,000+ monthly searchesAI Gateway Page Optimization
Context
Keyword gap analysis shows Kong dominates through a systematic "Learning Center" content strategy — ~70+ keywords are served by dedicated educational pages at
konghq.com/blog/learning-center/. APISIX currently routes most of these keywords to the homepage, which cannot compete with focused content. This PR establishes the Learning Center foundation and addresses the two highest-value content gaps.Test plan
yarn buildsucceeds for the website package/learning-center/route renders with both articles/ai-gateway/page has updated title and FAQPage structured data in source.htmlin build output)/learning-center/what-is-an-api-gateway/and/learning-center/what-is-api-management/are accessible