Connecting a custom domain to your Tangram app

‍
Summary:

This tutorial explains how to connect a custom domain to your Tangram app.

1. Access Domain Settings:
   • Log in as an admin on your Tangram app.
   • Navigate to the wrench icon → Settings → Publishing.
2. Add Domain:
   • Enter the desired domain or subdomain (e.g., app.yourcompany.com) and save.
   • Follow the setup instructions provided.
3. Set Up DNS Records:
   • Log into your domain registrar (e.g., Cloudflare, GoDaddy, Google Domains, etc).
   • Create a CNAME record with the subdomain as the hostname and the target value from Tangram.
4. Verify the Connection:
   • Wait for the domain to resolve (can be instant but may take up to 3 days).
   • Check that the status updates to “connected” and that the domain works as expected.

Important Notes:

• DNS propagation can take time, so set up the domain at least three days in advance of important events.

For questions or assistance, feel free to reach out at support@tangram.co‍

‍

Video Transcription:

 Hey, everyone. Today, I'm going to teach you how to connect a domain to your Tangerine map.  The way you'll want to get to the domain menu, first of all, is if you go to your Tangerine map and log in as an admin in the bottom left corner of your screen, you should see a wrench icon. If you click on that and then click settings, you'll want to click this third tab here, publishing.

From here, you can manage the custom domains connected to your app.  In this case, I'm going to be connecting a domain. I personally own docscreo. com.  We're going to do tangram. voxcrypto. com. You can put any subdomain you want here or the root domain. It just depends on what, you know, what host name you want on your app.

But in this case, we're going to put in tangram. voxcrypto. com. And the end goal is that when we put that in our URL bar, we should be able to navigate to our app from that domain.  We'll hit save and continue there. And then if you click here you'll see this modal with setup instructions.  It says to set up tangram.

voxcrayo. com, follow these steps. Log into our domain registrar, which we've already done. We have the domain settings open on Cloudflare right now.  We want to create a new record here. We're going to be creating a CNAME. And the subdomain we're using is tangram.  We put that as the value in the hostname field.

And then the target is going to be the value provided by the tangram app.  In our case, it's vertical ladybug, blah, blah, blah, blah, blah. We're going to paste that in the target field. And for now we're going to disable the cloud for cloud flare proxy. It's not relevant to this tutorial. I'm going to hit save on that.

And then we're going to just close this in a few minutes. Now this domain should start resolving.  I'm going to pause the video and I'll check back in when it's done.  We actually didn't have to wait long at all. It worked pretty much instantly. As you can see here, tangram. boxcreator. com slash login.

If I go to sign up. Domain is still there. If I refresh this tab in the app you know, we can see term of xcode. com still here. Eventually this status will say connected. If it says a waiting connection, it means things are still provisioning in some way. But as you can see, the domain is reachable right now.

I do want to warn you of a couple of quick gotchas that might come up during this process.  One thing that people commonly do is they'll put a in the name field here tangram. boxcreo. com, for example. And depending on your domain registrar, that could make the domain that you're actually entering look like this, like tangram.

boxcreo. com. tangram. boxcreo. com. It depends on what on where you're managing your DNS, but you'll want to make sure that you're entering the hostname as tangram. boxcreo. com. the thing you actually want to be there. The other thing is sometimes the resolution takes more than a few minutes. In this case, we got very lucky and it was almost instant.

but in some cases it can take up to three days to fully propagate. And that's not something that can be sped up.  When you want to connect a custom domain, you want to make sure you're doing it three days in advance of any like presentations or whatever you're doing that depend on having the live domain in place.

That should help you get fully set up with custom domains. If you have any questions, please feel free to let us know, but otherwise have a great rest of your day.