Running WordPress for a mainland China audience
WordPress is Limited rather than Unavailable in mainland China. Nothing bans the software, and self-hosted WordPress runs fine on mainland cloud. What fails is the set of overseas services a stock WordPress install assumes: the hosted WordPress.com service, the avatar service, and the update endpoints the admin dashboard calls. Answer three questions in order — what breaks in the page, where the site will be hosted, and how the admin stays patchable.
1. What actually breaks, service by service
Teams usually say WordPress is blocked in China when the truth is more specific. Separate the pieces before changing anything.
The pattern is that the site resolves and the HTML arrives, then the page stalls on blocked or slow third-party sub-requests. Fix the in-page dependencies before blaming the host: serve avatars locally, self-host the font files you use, and strip the emoji script and its DNS prefetch. Those three changes are free and often the single largest improvement for a China audience.
2. Decide hosting location before anything else
Hosting location determines your compliance workload, not your company's location or your audience. The ICP filing requirement follows the physical location of the server that serves the public site.
Two consequences are easy to miss. First, an offshore origin cannot be paired with mainland CDN nodes: Alibaba Cloud requires an MIIT filing number for its Chinese Mainland and Global acceleration regions, and only the region that excludes the mainland is filing-free. Second, offshore hosting removes the filing burden but keeps the cross-border path, which is exactly what causes inconsistent load times. Neither option is strictly better — pick the one that matches how committed the China audience is.
3. The self-host-onshore path and ICP filing
This is the path most teams end on when China traffic matters. Sequence it in this order, because each step gates the next.
Step 1 — Get the domain filing-eligible
A domain registered with an overseas registrar cannot be filed. Transfer it to a registrar approved by the Ministry of Industry and Information Technology (MIIT), complete domain real-name verification, and make sure the verified registrant details match the entity that will file. Tencent Cloud advises waiting a few days after real-name verification so the record syncs into the MIIT database before you apply, otherwise the provincial review can fail on stale data.
Step 2 — Buy the mainland server first
Filing is submitted through your access service provider, and the provider requires an eligible mainland instance on the account before it will accept an application. Note that Alibaba Cloud filing is only available through the China site (aliyun.com) with a verified account, and the filing workflow is Chinese-language only — plan for a Chinese-reading colleague or a local partner.
Step 3 — Submit through the provider and pass provincial review
The provider does an initial check, then forwards the application to the provincial communications administration that has jurisdiction over your entity. That authority sets its own document list and verifies the domain registrant details against the filing entity. Published timelines vary widely by province and by whether the entity is filing for the first time, so treat any single number you read as indicative rather than a commitment.
Step 4 — Publish the filing number and finish the follow-ups
Once approved, the ICP number goes in the site footer linked to the MIIT verification site; some provinces require additional notices. A separate public security bureau filing is commonly required after go-live (often cited as within 30 days) for mainland-hosted sites. Timelines and document lists vary by province and change over time — confirm the current requirements with your hosting provider and your own counsel before you commit to a launch date. Chinaready does not provide legal advice on filings.
Step 5 — Put assets on a China CDN
With the filing in place, a mainland CDN is available for images, CSS, JavaScript, and media. This is where onshore hosting earns its keep, and it is unavailable to offshore origins.
4. Keeping the WordPress admin usable on a mainland server
The most common surprise after moving onshore is that the dashboard stops being able to install or update anything. This is the HTTP 429 rate limiting from the wordpress.org update API, not a firewall block, and it has been reported by mainland site owners since 2019. Do not respond by disabling updates — an unpatched core and plugin set is the larger risk. Practical mitigations, roughly in order of how much control they give you:
- Route update traffic through a mirror. The community plugin WP-China-Yes redirects wordpress.org update, install, and translation requests to domestic mirrors. Kill 429 takes the other approach and proxies installs through overseas nodes. Both are third-party plugins that sit in your update path, so review the source and pin versions before trusting them on a production site.
- Give the server an outbound proxy. If your team already has a compliant outbound path, configuring WordPress to use it for outbound HTTP is the cleanest fix and leaves core update behaviour untouched.
- Manage updates from outside. Build and test the plugin and theme set on an overseas staging environment, then deploy to the mainland server as code. Slower per release, but it removes the runtime dependency entirely and is the usual answer for teams with a real deployment pipeline.
- Upload manually as a fallback. Downloading a plugin ZIP and uploading it always works and is a reasonable stopgap, but it does not scale past a handful of plugins.
5. Domestic CMS options worth knowing
Switching CMS is the right call in a minority of cases — usually when the site is a documentation portal, or when a government or state-owned buyer imposes domestic-technology (Xinchuang / 信创) and security-grading requirements that a PHP plugin ecosystem cannot satisfy. None of these is a drop-in WordPress replacement; themes, plugins, and content models do not carry over.
One thing to avoid: DedeCMS (织梦) still appears in older Chinese build guides, but it now requires commercial licensing and has a long public vulnerability history, and current domestic selection write-ups advise against it for new projects. Treat legacy PHP CMS recommendations from a decade ago with suspicion.
6. Headless WordPress with a China-hosted frontend
A decoupled setup keeps WordPress overseas as the editing tool and content API, and serves mainland visitors from a China-hosted frontend that consumes it. It is attractive because editors keep the interface they know, the admin stays out of the mainland network path, and update management happens in a jurisdiction where the wordpress.org endpoints behave normally.
It does not avoid ICP filing. The requirement attaches to the server that serves the public site, so a frontend hosted in the mainland needs a filing even though the WordPress admin sits overseas — the same logic that makes mainland CDN nodes require a filing number. Going headless changes where the CMS lives, not whether you file. Confirm the specifics for your architecture with your hosting provider and counsel.
Two practical notes. The frontend still needs to fetch content across the border at build or request time, so prefer building or caching content onshore rather than calling the overseas API on every page view. And an internet-exposed WordPress admin and REST endpoint is a standing security liability — restrict admin and API access to known networks, and authenticate the API rather than leaving it open.
Options named on this page are alternatives-page orientation candidates only — Chinaready does not add PageAdmin, Baklib, Z-BlogPHP, Halo, or WeChat channels as Explore / Landscape product tiles. Availability and blocking behaviour change; re-test from a mainland network before you commit. Compare nearby pages for Altis, Pantheon, Google Fonts, Cloudflare CDN, and Amazon CloudFront when the stack also includes managed WordPress hosting or overseas CDN and font delivery.
FAQ
Does WordPress work in China?
Yes, with work. Chinaready labels WordPress as Limited for mainland China. The software is not blocked and self-hosted WordPress runs normally on mainland cloud, but a stock install depends on overseas services that mainland visitors cannot load reliably — Gravatar avatars are blocked, Google Fonts is unreliable, and the wordpress.org update API rate-limits mainland servers. Sites usually resolve and then stall on those sub-requests, which is why WordPress feels broken in China rather than simply unreachable.
Is WordPress.com or WordPress.org blocked in China?
They behave differently, and the distinction matters. WordPress.com, the hosted service, is inconsistently reachable — GreatFire measurement across roughly 1,500 tested WordPress.com URLs shows a large share blocked or intermittently disrupted and the rest loading normally, so it is not a dependable China-facing host. WordPress.org is not blocked, but mainland server IPs frequently receive HTTP 429 Too Many Requests from its update API, reported since October 2019, which is a rate-limiting problem rather than a firewall block. Gravatar, which core loads for avatars, is blocked across every host with a verdict.
Do I need an ICP license for a WordPress site in China?
If the site is hosted on a mainland China server, you need an ICP filing before it may go live, and you also need one to use a CDN with mainland points of presence. The requirement follows the physical location of the server, not your company's location or your audience. Hosting in Hong Kong, Singapore, or anywhere offshore needs no filing — and cannot obtain one. Filing requires a filing-eligible domain at an MIIT-approved registrar with real-name verification matching the filing entity, an eligible mainland server on the provider's account, and the ICP number published in the site footer. Provincial requirements, document lists, and timelines vary and change, so confirm the current rules with your hosting provider and your own counsel. This is not legal advice.
Why can't the WordPress admin install plugins on a China server?
That is the HTTP 429 rate limiting from the wordpress.org update API hitting mainland IP ranges, which disables update checks and one-click installs across core, plugins, and themes. Options are to route update traffic through a domestic mirror plugin such as WP-China-Yes, proxy installs through overseas nodes with a plugin such as Kill 429, give the server a compliant outbound proxy for WordPress HTTP requests, manage the plugin set from an overseas staging environment and deploy as code, or upload plugin ZIP files manually as a stopgap. Review any third-party plugin that sits in your update path before trusting it in production, and do not simply switch updates off — an unpatched install is the bigger risk.
Should I host WordPress in Hong Kong instead of mainland China?
Hong Kong is a legitimate middle path when you do not have a mainland entity or want to launch quickly. It needs no ICP filing, and latency to mainland cities is commonly cited around 20–40 ms versus roughly 180–250 ms from the United States. The honest tradeoff is that traffic still crosses the border, so it shares congested cross-border links and degrades during the domestic evening peak, and you cannot pair an offshore origin with mainland CDN nodes because those require a filing number. If China is a primary market with sustained traffic, onshore hosting with a filing is still the performance ceiling.
What are the best China alternatives to WordPress?
Chinaready currently lists Self-hosted WordPress on China cloud, PageAdmin, Baklib on this page. For most teams the answer is not a different CMS: keep WordPress, move hosting onshore or to Hong Kong, and remove the blocked third-party assets. Switch CMS when the job has changed — PageAdmin for government, education, and state-owned site clusters with domestic-stack and security-grading requirements, Baklib for help centers and documentation portals, and Z-BlogPHP or Halo for lighter self-hosted content sites. None is a drop-in replacement, since themes, plugins, and content models do not carry over. These are alternatives-page orientation candidates only, not Chinaready Explore tiles.