Skip to main content

Configure SSL for help center

Help center allows you to create a portal and add articles from the chatwoot app dashboard. You can point to these help center portal articles from your main site and display them as your public-facing help center. We provide SSL certificate for your help docs through our chatwoot domain.

How to get SSL certificate for your custom domain

Create a Portal in Chatwoot's dashboard

Let's create a product documentation portal for, we will use this for the custom-domain

  1. Navigate to Help Center
  2. Click on "New Portal."
  3. Add basic information about your portal.
  • Add a custom domain at which you want to serve your portal: e.g. is your main site, and you want your portal at, then this will be your custom domain.
  • Add portal name; this will be the heading of your portal
  • slug is auto-generated do not change it.
  1. Add customization information about the portal for theme color, page title, header text and homepage. This can match the theme and style on
  2. Your portal is ready with no articles. To add articles, click on the portal settings button and add new categories and add articles in the respective category.


Once these steps are completed, you will have a portal with articles ready.

Point your custom domain to

  1. Go to your nameserver, go to its DNS settings and add a new CNAME record.

    • For the above example, add docs as a CNAME record and point it to the
    • For the Cloudflare nameserver, please below the attached image for reference. It's under DNS tab.


    • For the AWS nameserver, please see below-attached image for reference. It's under Route53 service.


    • If you have a different name server, these settings will be similar. Just go to the DNS settings and add a CNAME record. Or search for How to add CNAME record with your nameserver?.
  2. This will ensure that your CNAME record points to our server. For your custom domain, we have your portal information and the SSL certificate. In this case,

Providing SSL

  1. This process is handled by chatwoot for all the cloud customers.
  2. You need to reach out to us through Chatwoot support with your portal custom domain record.
  3. Or please email us with the subject "Issue SSL certification for {Portal Slug}"

NOTE: This step will take 1/2 working day/s from the chatwoot team for the setup.

Voila! is live with a secure connection, and your portal data is visible.

How does this work?

These are the engineering details to understand How does gets the portal data with SSL certificate.

  1. When the customer point to through CNAME, DNS points it to our site, but it's not valid yet.
  2. Then Customer from the browser requests us to serve endpoint with the portal's data.
  3. To validate the routing from to, we add a record in our heroku.
  • This is to validate Heroku DNS routing and validate the custom domain.

  • Go to Heroku dashboard -> Chatwoot -> Settings

  • Go to Domains section and add a new domain to serve, in this case,


  • After we add the domain successfully and ACM status will be waiting to verify the cert issue and will show an error later as SSL is not yet provided for the custom domain.


  1. Heroku won't allow serving until we provide the SSL certificate.

  2. For this, we go to our Cloudflare dashboard and certify the record for

    • Go to Cloudflare dashboard ->

    • Go to SSL/TLS -> custom hostname dns

    • Add a record for, with certification validation method HTTP Validation and certificate type `Provided by Cloudflare

  3. Wait till the custom hostname reflects with SSL certificate active.

  4. Go back to Heroku and check the ACM status for the shows Ok now.

Cloudfare's custom hostname functionality provides the certificate to the custom domain that we add.

  1. resolves by customers nameserver and redirects to
  2. nameserver certifies the
  3. Chatwoot's heroku domain's settings validate the certificate and routes to root dashboard.
  4. check for the portal record with custom-domain
  5. Redirects to the portal records for the domain
  • yourdomain


Now you can have your own help-center, product-documentation related portal saved at Chatwoot dashboard and served at your domain with SSL certificate.