- 24 May 2023
- 3 Minutos para leer
- Colaboradores
- Impresión
- OscuroLigero
- PDF
Hosting Document360 on a sub-directory
- Actualizado en 24 May 2023
- 3 Minutos para leer
- Colaboradores
- Impresión
- OscuroLigero
- PDF
What is subfolder hosting?
A subfolder hosting is a type of website hierarchy under a root domain that uses folders to organize content on a website. A subfolder is the same as a subdirectory, and the names can be used interchangeably.
The subfolder/subdirectory comes after the root directory or domain name in a URL.
For example, Document360’s root domain is
document360.com
. So a subfolder/subdirectory path URL might bedocument360.com/docs/
.
Most companies host their documentation under a subfolder/subdirectory on their website domain.
For example:
example.com/docs
,example.com/support
, etc.
This is because hosting a knowledge base on a subdirectory/subfolder of a website (example.com/docs
) rather than a subdomain (docs.example.com
) is better for Search Engine Optimization (SEO).
Subfolder/subdirectory hosting can be enabled for Document360 provided domains and mapped custom domains.
Enabling Subfolder hosting
To enable the subfolder hosting for your project,
- Go to the desired project in Knowledge base portal
- Click Settings → Knowledge base site → Custom domain → Sub folder hosting(tab)
- By default, the Subfolder path is set to /docs
- Click on Enable in the Enable/Disable switch for subfolder hosting
Subsequently, if you want to disable the subfolder hosting on your project, you can click on 'Disable'
Custom sub folder paths
You can also set up your knowledge base on subfolder/subdirectory paths other than /docs
.
For example,
/help
,/support
, etc.
- On the Document360 Knowledge base portal
- Go to Settings → Knowledge base site → Custom domain → Sub folder hosting(tab)
- By default, the Subfolder path is set to /docs
- Click inside the field, delete the docs and type in your custom subfolder path (For example,
/help
) - Click on the Update button on the right
- This new custom subfolder would only work in the subfolder hosting setting is enabled in your project
When setting up other paths, make sure you add the languages associated with each workspace in your project. This configuration varies depending on the different web servers.
For projects configured with custom domain and subfolder hosting the "Article preview" is not supported yet.
Web servers
Here are some of the commonly used web servers
- Apache HTTP server
- Nginx server
- ASP.NET Core server
- Microsoft - IIS server
- OpenResty server
- LiteSpeed server
- Cloudflare server
What is a web server?
A web server stores and delivers the content for a website – such as text, images, video, and application data – to clients that request it. The most common type of client is a web browser program.
Helpful links
Determine your web server and add the code snippets (provided for respective web servers below) to your own web server configuration.
Nginx server
Apache HTTP
ASP.NET Core
Microsoft - IIS
What happens next?
Once you have successfully configured the web server, your Knowledge base site is now live on your custom subfolder/subdirectory. However, the existing URL for your project will serve the requests.
For example,
example.document360.io
andexample.com/docs
(if/docs
is your folder path) will point to the Knowledge base site.
This will cause duplicate content in Search engines (Google, Bing, etc.). For this, you will need to enable a URL redirect.
To enable the redirect from example.document360.io
to example.com/docs
, please contact us at support@document360.com.
Related videos
Hosting your knowledge base on a subfolder