How to Set Up a Custom Subdomain
Use a custom subdomain for your help centre instead of the auto-generated one. Custom subdomains are available on Starter and higher plans.
What is a Custom Subdomain?
A custom subdomain lets you choose your own subdomain name instead of using an auto-generated one. For example, instead of yourcompany.dedox.ai, you could use docs.yourcompany.dedox.ai or help.yourcompany.dedox.ai.
Plan Availability
Custom subdomains are available on:
-
Starter Plan: Custom subdomain available
-
Team Plan: Same as Starter
-
Professional Plan: Custom subdomain available
-
Enterprise Plan: Custom subdomain available
-
Free Plan: Auto-generated subdomain only
Setting Up a Custom Subdomain
Step 1: Check Availability
-
Go to your help centre settings
-
Find "Subdomain" section
-
Enter your desired subdomain
-
Check if it's available
Step 2: Choose Your Subdomain
Best practices:
-
Keep it short: Easy to remember and type
-
Use clear names:
docs,help,support,knowledge -
Match your brand: Use your company or product name
-
Avoid special characters: Only letters, numbers, and hyphens
Examples:
-
docs.yourcompany -
help.productname -
support.service -
knowledge.base
Step 3: Update Subdomain
-
Enter your desired subdomain
-
Click "Update Subdomain" or "Save"
-
Confirm the change
-
Your help centre will be available at the new URL
Subdomain Rules
Allowed Characters
-
Letters (a-z)
-
Numbers (0-9)
-
Hyphens (-)
-
Must start and end with a letter or number
Restrictions
-
No spaces: Use hyphens instead
-
No special characters: Only letters, numbers, hyphens
-
Case insensitive:
DOCSanddocsare the same -
Must be unique: Each subdomain can only be used once
Changing Your Subdomain
When You Can Change
-
Any time: Change subdomain whenever needed
-
No downtime: Changes take effect immediately
-
Update links: Update any bookmarks or links
How to Change
-
Go to help centre settings
-
Find subdomain section
-
Enter new subdomain
-
Check availability
-
Save changes
-
Update any external links
Custom Subdomain vs Custom Domain
Custom Subdomain
-
Format:
yourcompany.dedox.ai -
Available on: Starter+ plans
-
Setup: Instant, no DNS configuration
-
Cost: Included in plan
Custom Domain
-
Format:
docs.yourcompany.com -
Available on: Starter+ plans (1-3 domains depending on plan)
-
Setup: Requires DNS configuration
-
Cost: Included in plan
You can use both: a custom subdomain on Dedox AND a custom domain pointing to it.
Best Practices
Choosing a Name
-
Be descriptive: Make it clear what the help centre is for
-
Keep it simple: Easy to remember and type
-
Consider SEO: Use relevant keywords
-
Think long-term: Choose something you'll keep
Updating Links
-
Internal links: Update any internal article links
-
External links: Update links on your website
-
Bookmarks: Update saved bookmarks
-
Documentation: Update any documentation references
Troubleshooting
Subdomain Not Available
-
Try a different name
-
Add numbers or hyphens
-
Use a variation of your desired name
-
Contact support if you believe a subdomain should be available
Subdomain Change Not Working
-
Wait a few minutes for propagation
-
Clear your browser cache
-
Try accessing from a different browser
-
Contact support if issues persist
Can't Access After Change
-
Verify the new subdomain is correct
-
Check you're using the right URL
-
Clear browser cache
-
Try incognito/private browsing mode