All Collections
Sharing your docs
Publishing
Publish docs on a custom domain
Publish docs on a custom domain

Learn how to publish your Coda docs to your own custom domain

Updated over a week ago

Coda now allows you to publish your Coda docs to your own domain instead of just on your Coda.io maker profile. You can use Coda in conjunction with the domain registrar of your choice (GoDaddy, Namecheap, etc) to create a personal portfolio, interactive resume, publish a job description, stand up a quick landing page, and more.

Within this article you'll find...


Adjust your published doc settings

Published docs are published to your maker profile on the coda URL. Custom domains, on the other hand, allow you to publish a Coda doc to your own domain, meaning you can have a custom URL for people to view your Coda doc. There are a few things to note before you set up a custom domain for your Coda doc.

Before you can access custom domains, your doc needs to be published. And when you publish your doc, be sure to make is discoverable (this is required for custom domains). To do so, just toggle on the Discoverable by anyone option within the Publish settings.

Following the above process will make sure your doc’s share settings are set so Anyone with the link can view. This is how Coda is able to share your published doc to your custom domain. You will see this setting in the Doc’s share settings. If you decide to change this to No Access at any time, it means your doc will no longer be viewable via your custom domain.

Determine the correct publishing mode

When you publish your doc, you'll be able to choose between three different interaction modes: View, Play, or Edit.

When publishing to a custom domain, you'll generally want to choose either View or Play mode. When users visit your custom domain, View mode will allow them to only view the doc. Play mode will allow them to see and interact with the doc. But they will not be able to comment, edit, or react, as that functionality requires that they are logged into Coda.

You may choose Edit mode, but this is generally not recommended. An editable doc requires the editor to have a Coda account and be logged in to Coda. Therefore, when users visit your custom domain, they would be able view your doc but not interact with or edit it in any ways. Instead, to edit your doc, users would have to access your doc with the standard published doc URL.

Connect your doc to your domain

To connect your doc to the domain you want it to be accessed with, follow these steps:

  1. From your doc’s Share settings (upper right corner of your doc), make sure that it is set to Anyone with the link - can view

  2. Navigate to the Settings tab (from the gear icon in the upper right corner of your doc) and select the Publish this doc option

  3. Click the blue Publish doc button and publish your doc, making sure that Discoverable by anyone is toggled on.

  4. Under the Add a custom domain title, enter the domain you want your doc to connect to, such as “www.example.com”

  5. Select where your domain is registered, such as GoDaddy or Namecheap.

  6. At this point, you’ll need to log in to your domain registrar and edit the DNS settings for the domain there. You can find detailed instructions on how to do so directly in the product. Just look for Show step by step instructions as you go through the connection flow, or check out the FAQ below for more info.

  7. Once you’ve setup the connection, it will take 5-10 minutes to initialize, depending on your DNS provider. You will receive an email from Coda when your connection has been successfully enabled or if we have trouble enabling the connection, in which case you may need to double-check your DNS configuration.

custom domains flow.gif

FAQs

How do I edit the DNS settings of my domain registrar?

These are edits that you'll need to take directly in your domain registrar, rather than in Coda. And therefore, every registrar has slightly different steps for this. But to help you out, we've included step-by-step instructions for some of the most common registrars directly in Coda. When you connect to your registrar in Coda, you'll see an option to Show step by step. Also, once your custom domain is set up, you can revisit these instructions by clicking on the gear icon in the upper right corner of your doc, selecting Publish this doc, then clicking into Custom domains. Then, under the Domain settings section, look for View full instructions.

Should I use “www” or not when entering my domain?

When you enter the url of your custom domain when setting up the connection in Coda, you can enter it either with “www” or without. In order for both variations to direct to your published doc however, you will need to set up domain redirects within your DNS provider. Check out the above FAQ for more info on this.

Can I connect my doc to a subdomain?

Yes! Simply start by adding the full domain, including subdomain, you want to connect to your doc into Coda (eg mydoc.example.com). Follow the instructions, and make sure the host name you enter into your domain provider DNS record is your subdomain.

For example, your CNAME record for the above example would have a host of mydoc (not www) and the TXT record would have a hostname of _coda.mydoc.

Can I connect one doc to multiple domains?

No, currently only connecting one custom domain to each individual doc is supported by Coda publishing.

Can my doc be editable on a custom domain?

No, an editable doc requires the editor to have a Coda account and be logged in to Coda. However an editable Doc will still be viewable on your custom domain.

If you want to publish an editable doc, you can set your doc to be editable in the publish settings, and your published doc will be able to be edited (via your published doc URL) and your custom domain will remain viewable.

Can I connect to a custom domain without publishing to the Gallery?

Currently, in order to use a custom domain, your doc must be published and also discoverable, meaning it can be found by search engines and also in the Coda Gallery. We’re working on unpairing these two options, enabling you to set publishing to the Gallery or discoverable by search engines separately. Stay tuned!

How long does it take to connect to my domain?

After entering the domain information in Coda and editing your DNS settings with your domain provider, the connection will typically complete within 5-10 minutes. You will receive an email from Coda when your connection has been successfully enabled or if we have trouble enabling the connection, in which case you may need to double-check your DNS configuration.

My domain is connected, but my doc isn’t loading. What's wrong?

If you are noticing this behavior in your published doc, check to make sure it is set to “Discoverable” within the publishing settings. If your doc is not discoverable, it will still be able to connect to the custom domain, but Coda will be unable to load it.

Do I need to republish/reconnect to see changes to my doc?

No, the changes you make within your doc will automatically appear in the published version, within a few seconds to a minute.

Parts of my doc aren’t working on my custom domain - what's wrong?

Docs published to a custom domain are only able to be presented in “View” or “Play” mode, so elements of your doc such as reactions will not be functional within the published version. Pack functionality may also be limited within your custom domain doc. Additionally, sync pages are not currently supported on docs published to custom domains.

I changed my docs share settings, and now my custom domain isn’t working?

Your doc’s share settings must be set to “Anyone with the link can view” in order for Coda to be able to share your published doc to your custom domain. If you decide to change this to “No Access” at any time, it means your doc will no longer be viewable via your custom domain.

Is custom domains free?

No, publishing your doc to a custom domain is not available on Coda’s Free tier. All of Coda’s paid tiers including Pro, Team, and Enterprise have access to an unlimited amount of custom domain docs. Learn more about upgrading here.


Related resources:

Did this answer your question?