Jamdesk Subdomains
Your default yourproject.jamdesk.app subdomain: naming rules, how to change it, and when to switch to a custom domain.
Every Jamdesk project gets a free subdomain at yourproject.jamdesk.app. It is your default documentation URL.
How Subdomains Work
Jamdesk assigns a subdomain from your project slug when you create a project:
| Project Slug | Subdomain |
|---|---|
my-docs | my-docs.jamdesk.app |
acme-api | acme-api.jamdesk.app |
company-help | company-help.jamdesk.app |
Your subdomain is active as soon as your first build completes.
Subdomain Naming Rules
- Lowercase letters, numbers, and hyphens only
- Must start with a letter
- Cannot start or end with a hyphen
- 3-63 characters long
- Must be unique across all Jamdesk projects
Changing Your Subdomain
- Go to your project in the Dashboard
- Open Settings → General
- Update the Project Slug field
- Click Save
Changing your subdomain breaks existing links. Search engines and external sites linking to your old subdomain will get 404 errors. Set up a custom domain instead if you need stable URLs.
What changes:
- Your new subdomain is active immediately
- The old subdomain returns 404
- Bookmarks and external links break
- Search engine rankings reset
SSL Certificates
Jamdesk provisions SSL certificates for every *.jamdesk.app subdomain. HTTP requests redirect to HTTPS.
Rate Limits
Jamdesk subdomains share infrastructure with other projects. For high-traffic documentation:
- Use a custom domain for dedicated resources
- Contact support if you expect sustained high traffic
When to Use a Custom Domain
Pick a custom domain if:
- You need URL stability (subdomain changes break links)
- You want your docs at
docs.yourcompany.com - You need to match your company's domain
- Your documentation is customer-facing
See Custom Domains for setup instructions.
Subdomain vs. Custom Domain
| Feature | Subdomain | Custom Domain |
|---|---|---|
| Setup time | Instant | 10-30 minutes |
| Cost | Free | Free (you provide domain) |
| URL format | project.jamdesk.app | docs.yourdomain.com |
| SSL | Automatic | Automatic |
| Branding | Jamdesk branded | Your brand |
| URL stability | Tied to project slug | Permanent |
