How do you make your website live in mainland China?
You make a site live in mainland China by clearing a sequence of legal gates — a mainland business entity, an ICP filing bound to in-country hosting, and PIPL-compliant handling of your users' data — not by making a foreign site load faster. Until that filing is granted, a mainland-hosted site cannot be reached at all.
China's rule is that a site served from inside the mainland may not operate, and no access provider may connect it, until it carries a valid ICP record-filing (State Council Order No. 292; MIIT Order No. 33) — which is why an unfiled domain returns the blank page the guide shows, and why the filing number has to sit in your footer. The filing is granted to a Chinese legal entity and tied to a specific in-country host, so "we already run on GitHub and AWS" does not carry over: those global accounts sit on a separate footing in the mainland, and serving China's users from offshore turns their personal data into a cross-border transfer PIPL governs. The steps below walk the practical path — stand the site up on in-country delivery you can keep using with your existing stack, test it, then file — and the facts below mark where each legal gate falls.
Which gate is your real blocker turns on your entity, your data and who your users are — confirm the specifics with counsel. Our China team can map your path with you →
What actually decides whether your site can go live in China
| Fact | Primary source |
|---|---|
| No ICP filing means no live site — and no connection. Under China's record-filing regime, "without record-filing, no one may engage in non-operational internet information services within the territory" (filing Measures, Art. 5), and an internet access provider "shall not provide internet access services" to a site that has not filed (Art. 18). That — not slow loading — is why an unfiled mainland domain returns a blank page: the filing is the permission to operate, issued under State Council Order No. 292 and MIIT Order No. 33. How ICP filing works → | Administrative Measures for the Filing of Non-operational Internet Information Services (gov.cn), Arts. 5 & 18, retrieved 2026-10-07; MIIT Order No. 33 |
| The filing is granted to a China entity and bound to in-country hosting; a global account does not carry over. Record-filing applies to services provided "within the territory of the People's Republic of China" (filing Measures, Art. 2); the access provider that connects a site must record its filing information (Art. 19) and may not connect an unfiled one (Art. 18) — so a site served from outside the mainland cannot be filed. The parent rule, State Council Order No. 292, also sorts sites into non-commercial (which need this filing) and commercial (which need an operating permit on top). That is why Step 5's "company entity registered in China" is the real precondition, and why a global GitHub or AWS setup is re-established in-country rather than switched on. The parent Measures (Order 292) → | Measures for the Administration of Internet Information Services, State Council Order No. 292 (gov.cn), retrieved 2026-10-07; Filing Measures Arts. 2 & 18-19; MIIT Order No. 33 |
| Once filed, the number must show in your footer — by law, not custom. A provider "shall, when its website goes live, indicate its filing number at the bottom-center of the homepage" and link beneath it to the MIIT record-filing system (filing Measures, Art. 13); a complete filing is processed "within 20 working days" and a number issued (Art. 12), and failing to display it is itself penalized (Art. 25). That is the ICP number you see in the footer of every site operating from the mainland. | Administrative Measures for the Filing of Non-operational Internet Information Services (gov.cn), Arts. 12, 13 & 25, retrieved 2026-10-07 |
| Where your users' data lives is a second gate, separate from the filing. Serving China's users from offshore keeps you out of the filing regime but makes their personal information a cross-border transfer: PIPL requires you to inform them and obtain "separate consent" (单独同意), and to use one of three routes — a security assessment, certification, or the standard contract (PIPL Arts. 38-39). Critical-information-infrastructure operators and high-volume handlers must keep mainland personal data in the mainland (PIPL Art. 40; Cybersecurity Law Art. 39). Which route and thresholds apply → | Personal Information Protection Law (PIPL), Arts. 38-40 (npc.gov.cn), retrieved 2026-10-07; Cybersecurity Law Art. 39 |
Sources verified by the 21YunBox compliance team on 2026-10-07.
Getting your websites to work in China can be tricky. You probably know Google, Facebook, Uber, and many other big tech companies had tried coming to China but failed. There are many reasons for the failures but the things I’m about to tell you will save you time and money to prevent mistakes.
Github and AWS don’t work in China
Any successful web apps can’t live without version control and hosting platforms. Github and AWS, the two most popular services in the world don’t work in China. What do I mean by “don’t work in China?”. More specially, say you want to clone a project to a server in China, what you normally do is:
git clone repo_name.git
but you can only get up to 10kb/s speed to download your code in China, and in fact, you get this regularly:
"fatal: unable to access '<your_repo>': Failed to connect to github.com port 443: Timed out"
So this means you will have a hard time cloning your project to a server in China and the overall developers’ experience in China would be terrible.
What’s more?
AWS (Amazon Web Service), GCP (Google Cloud Platform), and the cloud platforms you love don’t work in China. If you have been using AWS, you know you can switch regions and spin up servers in minutes. When you come to China, whatever you do on AWS, you need to replicate it on AWS China again and then apply for the ICP License.
Wait for a second, isn’t AWS China just another region of the AWS system? Sorry to tell you it’s not, it’s on its own system in China, and the only two regions (Beijing and Ningxia) are not operated by AWS directly, in fact, it is operated by another two different companies in China.
What’s ICP License?
ICP (Internet Content Provider) License is a permit to have your websites go live in China. I know you are probably curious what happens if I don’t have an ICP License and try to push a website up online, you will see this on your browser while visiting your domain:
What it means is that no one can see your website. What happens behind the scene is that the default 80 and 443 ports are blocked for all servers in China before your ICP filing is completed.
Anything else?
I hated you tell you there are more, here are some of them that I think you don’t want to miss:
- Payment Processing Services: Stripe, Paypal, and Square;
- Social Network: TikTok, Facebook, Instagram, and Snapchat;
- Video sharing platforms: Youtube and Vimeo
You read it right, TikTok is on the list.
Isn’t TikTok a Chinese-owned company? Right, but the one Chinese users use is called Douyin, and TikTok is for users outside of China. These two apps share a similar user interface and are owned by the same company.
If I’m going to list every service that doesn’t work in China, I’m probably running out of space here, but I guess you probably get what I mean already. The point I’m going to make is that the technology you familiar with doesn’t work in China.
The good news
Like I promised in the beginning, I will walk you through the steps to make your website live in China with the tool you are familiar with. Here are the steps and actions:
1. Sign up on 21YunBox
Click here to get an account.
What is 21YunBox? If you have used services like Netlify, Vercel, or Heroku, you probably like the way they make deployment easy. 21YunBox does the same and is optimized to give the best performance in China that you can’t get anywhere. Simply put, it is a hosting platform that enables you to use the tech you familiar with inside China.
If this doesn’t make sense to you, let’s look at it this way, instead of you hosting a website with a Ubuntu server on AWS (meaning you install docker, Nginx, system libraries, and many other things to get a website up live), these platform pre-install everything you need to run web apps and databases, you just need to write the code and commit changes, within minutes, you will see your website live.
2. Connect your Code
Connect your Github repository on 21YunBox Console.
Wait for a second, didn’t I say Github doesn’t work in China above? Yes, it doesn’t work in China. But we make Github work by utilizing dedicated networks between China and other countries internally. So you can use Github normally inside China, this means you have a fast git clone and fast speed on pulling libraries. Like I promised to you can use the technology you are familiar with inside China on 21YunBox.
3. Build the sites you want, with the tools you love
Pick the stack you are using and deploy it on 21YunBox in minutes:
Static Site Generator + Headless CMS + Hosting Solution:
- Deploy Gatsby + Sanity + 21YunBox
- Deploy NextJs + Strapi + 21YunBox
- Deploy NuxtJs + Contentful + 21YunBox
- Deploy React + Airtable + 21YunBox
Backend Framework + Database:
- Deploy ExpressJS + MongoDB
- Deploy Ruby on Rails + PostgreSQL
- Deploy Django + PostgreSQL
- Deploy Laravel + MySQL
Don’t see your stack? You can check out our docs to learn more or submit a feature request.
Hopefully, by now, you are clear on what to do to get your website live in China. The following two steps will make sure you have everything covered to host your site on a root domain legally, let’s move on.
4. Test Your Site Live
If you have just spend few minutes completing the steps from above, you probably see your website live in China already (on a 21YunBox sub-domain). With the site present in China, you can pass it to the content team in China to perform user acceptance tests, and have some early users open it to see the speed boost in China.
The next thing would be to configure your DNS (Domain Name Server) to send traffic to the new site in China. If you still remember what I told you earlier: your site will be inaccessible if you don’t have an ICP. We also have this covered for you, read the next step.
5. Get Your ICP License
If you have a company entity registered in China, all you need is just follow our guide and put together the required docs and send it to us. It normally takes 10-20 business days for us and the MIIT (Ministry of Industry and Information Technology of the People’s Republic of China) to process.
During the process, you would expect to get 2 phone calls to verify you are operating this website legally from MIIT, after that you will have an ICP number and you need to put it on the footer of your website. For example, here is Nike’s website and its ICP no.
What happens if I don’t have a company entity in China? Then there are many possible solutions for you, click here to schedule a call with us, so we can answer your questions on the phone.
Frequently Asked Questions
Do I need an ICP filing if my site is already live outside China?
To host it inside the mainland and have it reachable there, yes. The record-filing regime applies to sites served from within the territory, and the Measures are explicit that without a filing no one may provide such a service and that access providers may not connect an unfiled site. Hosting offshore avoids the filing, but leaves you the delivery problem the guide describes and, if you serve China's users, PIPL's cross-border obligations. Treat which path fits as a risk question to work through with counsel, not a fixed yes or no.
Can we just use our existing GitHub and AWS accounts in China?
Not as they are. As the guide notes, AWS's China regions run on a separate system operated by Chinese companies, and a global account does not extend into them; GitHub and many other services are also unreliable from inside the mainland. The workable path is to keep your code and stack but deploy them onto in-country delivery and connectivity, then complete the ICP filing — the familiar workflow stays while the legal footing underneath it changes.
Can 21YunBox help make our site live in China?
Yes. This guide is the path we run with clients: stand your site up on ICP-ready, in-country delivery using the stack you already have, test it in China, and complete the ICP filing with the MIIT — and, where your users' data crosses the border, map your PIPL cross-border and data-residency obligations for your entity and data volumes. If you don't yet have a China entity, that is one of the first things we work through with you. Get in touch to map your specific case.