Hub documentation

Spaces Custom Domain

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Spaces Custom Domain

This feature is part of PRO or Team & Enterprise plans.

Getting started with a Custom Domain

Spaces Custom Domain allows you to host your Space on a custom domain of your choosing: yourdomain.example.com. The custom domain must be a valid DNS name.

Custom domains require your Space to have public visibility. They are not supported on private Spaces. Support for a new Protected visibility (public app, private code) is coming soon.

Setting up your domain

You can submit a custom domain in the settings of your Space, under “Custom Domain”. You’ll need to add a CNAME record pointing your domain to hf.space:

Verifying your domain

After submission, the request will move to “pending” status:

Once the DNS is properly configured, you’ll see a “ready” status confirming the custom domain is active for your Space.

If you’ve completed all the steps but aren’t seeing a “ready” status, you can enter your domain here to verify it points to hf.space. If it doesn’t, please check your domain host to ensure the CNAME record was added correctly.

Removing a Custom Domain

Simply remove a custom domain by using the delete button to the right of “Custom Domain” in the settings of your Space. You can delete while the custom domain is pending or in ready state.

Update on GitHub