Setting Up a Custom Domain
If you’re in our help docs, you’ve probably noticed that the URL has changed from acquire.io to help.acquire.io. The word ‘help’ in this case is what we call a subdomain.
Subdomains are useful for organizing the information on your site, improving your SEO performance, and directing visitors to pertinent information.
In this article:
- Creating a Custom CNAME Record
- How to Create a Custom CNAME with a Service Provider
- Entering Your Custom Domain in the Knowledge Base
- Adding and Deleting Additional Domains
Creating a Custom CNAME Record
By default, your content is available through provided URL. If you’d like to use a different URL, you can create one by setting up a custom domain.
How to Create a Custom CNAME with a Service Provider
These steps will vary from provider to provider, so check with your DNS provider for support. In general, you will need to:
Step 1: Log in to your DNS provider’s site
Step 2: Go to the ‘DNS’ section and add a CNAME record for your Knowledge Base custom domain. Popular Knowledge Base names include help, docs, developer, etc.
Step 3: Point your new subdomain at kb.acquire.io. You may need to save changes.
Subdomains often take a couple of days to become active.
Entering Your Custom Domain in the Knowledge Base
After you’ve set up a custom domain, you’ll need to set it up in Acquire.
In Knowledge Base, select the three dots (‘...’) next to 'Knowledge Base (Default)' (or the Knowledge Base you'd like to connect) and select ‘Edit’ from the dropdown menu.
Enter your custom domain in the ‘Custom Domain’ field.
Adding and Removing Additional Domains
You may have products that need their own Knowledge Bases. To add more domains go to your Knowledge Base, press ‘+ Add Knowledge Base’. You will need a unique CNAME for each Knowledge Base you create.
Once you’ve deprecated an old Knowledge Base, it’s best to remove it. Before you do so, consider exporting the articles. You will not be able to retrieve articles from a deleted Knowledge Base.
To delete, go to the Knowledge Base and click on the three dots (‘...’) next to it. Select ‘Delete’ from the dropdown menu.
To export articles, go to the Knowledge Base and select the dropdown menu from ‘Add Article’ and press on ‘Import Articles’.
Having trouble? Reach out to your web developer or contact firstname.lastname@example.org.