Overview
CodeHS uses the domains codehs.xyz, codehs.me, and codehs.io to host curriculum content, such as interactive webpages, and HTML programs created in CodeHS assignments or the Sandbox. District and school network filters must allow codehs.xyz and either codehs.me or codehs.io for teachers and students to access curriculum and program output hosted on these domains.
The Test Content Hosting Domains Tool (https://codehs.com/test_codehs_domains) shows the status of your connection to the codehs.xyz, codehs.me, and codehs.io domains. It also checks the esm.sh and unpkg.com domains, which React Native and Mobile Apps programs on CodeHS use. The tool attempts to connect to each domain and shows whether the connection was successful.
CodeHS.xyz: Required Domain for CodeHS Curriculum
codehs.xyz must be unblocked by network filters for CodeHS to function properly. It hosts content the CodeHS team creates and embeds throughout the curriculum. If it’s blocked, teachers and students won’t see that embedded content in CodeHS exercises.
CodeHS.me or CodeHS.io: Required Domain for Viewing HTML Programs
To view HTML program output in the Code Editor or as a published webpage, you need one of these two domains unblocked, not both.
codehs.me (default): By default, HTML assignment and Sandbox programs are hosted on codehs.me and are private. Districts and teachers can allow codehs.me programs to be shared publicly within CodeHS Sections or on the wider internet. Learn more about CodeHS program privacy in Managing Student Access to Public Programs on CodeHS.
codehs.io (available on request): HTML programs hosted on codehs.io are always private. Districts and schools can opt in to codehs.io if they wish to block access to public websites hosted on codehs.me. Learn more about this in Using the CodeHS.io Domain for HTML Assignments & Sandbox Programs.
Domains for React Native and Mobile Apps Programs
If your students write React Native or Mobile Apps programs, your district will need to allow two domains that deliver the required code libraries:
esm.sh: Serves the libraries that turn React Native code into something the browser can display. If it’s blocked, the simulator stays blank when students run their code.
unpkg.com: Serves the tool that translates student code into what the browser runs. If it’s blocked, the simulator shows a compile error instead of the student’s app.
Both domains are public, read-only open-source package hosts. The browser only downloads library files from them, and no student data is sent.
Testing Content Hosting Domain Access
When you visit the Test Content Hosting Domains tool page, the tool checks each domain automatically when the page loads. Allow a few seconds for the tests to finish. The React Native and Mobile Apps domains show “Checking…” until their tests complete.
For accurate results, run the test on the same network and type of device your students use. Network filter settings may differ between home and school networks and between teacher and student devices and accounts.
Successful Tests
A successful test means the domain loaded on your network and the tool shows a successful connection. No action is needed for that domain.
CodeHS.xyz, CodeHS.me, CodeHS.io Success
Successful tests for the codehs.xyz, codehs.me, codehs.io domains show the message: "Success. This domain is functioning properly."
esm.sh and unpkg.com Success
Successful tests for the esm.sh and unpkg.com domains show the message: "Loaded."
Your network is set up correctly when the following are true:
codehs.xyz is successful.
codehs.me or codehs.io is successful, whichever one your school uses for HTML program hosting. You don’t need both. If your school uses codehs.me, an unsuccessful codehs.io result won't affect teacher and student access. If your school uses codehs.io, an unsuccessful codehs.me result won't affect teacher and student access.
esm.sh and unpkg.com are both successful, if your students write React Native or Mobile Apps programs.
Unsuccessful Tests
Test results that don't show a success message signal that your network filter may be blocking that domain. Ask your IT team to allow the domains that failed the test, then refresh the testing tool page to run the test again.
More Domain Resources
For the full list of domains to whitelist, see CodeHS Whitelist Domains.
For more details about required CodeHS domains that can be shared with IT teams, see CodeHS Domain Requirements.
Still have questions? Contact our team at support@codehs.com to learn more!