Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 12 additions & 5 deletions help/article/email-campaigns.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,10 @@

You’ll receive DNS setup instructions and values to connect the domain. A **DMARC** record will also be provided — we strongly recommend adding it to help prevent email spoofing.

If your email domain's DNS is hosted on **Vercel** or **Cloudflare**, you can skip manual DNS setup entirely. Click **Auto configure with Vercel** or **Auto configure with Cloudflare** on the DNS records screen, approve the request on your provider's side, and the correct MX, SPF, DKIM, and DMARC records will be added for you automatically.

Check warning on line 46 in help/article/email-campaigns.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/email-campaigns.mdx#L46

Did you really mean 'Vercel'?

Check warning on line 46 in help/article/email-campaigns.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/email-campaigns.mdx#L46

Did you really mean 'Vercel'?

If you don't have access to your domain's DNS settings yourself, click **Forward instructions** to email the exact records needed straight to whoever manages your DNS (e.g. your IT team or domain registrar) - no manual copy/pasting required.

<Frame>
<img
src="https://assets.dub.co/cms/email-domain-records-3.png"
Expand All @@ -65,7 +69,7 @@

“Warming up” your domain means gradually increasing your email-sending volume to build trust and improve deliverability. The goal is to send consistently without sudden spikes that might look suspicious to inbox providers.

Any time you start using a new domain or expect a large increase in sending volume, you should warm up your domain. A thoughtful warm-up plan helps prevent greylisting, throttling, and spam filtering, while building a solid sender reputation.

Check warning on line 72 in help/article/email-campaigns.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/email-campaigns.mdx#L72

Did you really mean 'greylisting'?

Keep an eye on your [bounce rate](#email-analytics), as it should stay below **4%**. If it rises above that, slow down your sending and review the cause.

Expand Down Expand Up @@ -104,7 +108,7 @@
**Examples**:

- “Introducing our newest feature”
- “Black Friday / Cyber Monday promotion”

Check warning on line 111 in help/article/email-campaigns.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/email-campaigns.mdx#L111

Did you really mean 'Cyber'?
- “Check out our latest blog post or promo video”

### Transactional
Expand Down Expand Up @@ -173,16 +177,16 @@
| ----------------- | -------------------------------------------- |
| Bold | `**Bold text**` |
| Italic | `*italic text*` |
| Strikethrough | `~~Strikethrough text~~` |
| Strikethrough | `~~Strikethrough text~~` |
| Inline Hyperlinks | `[Dub](https://dub.co)` |
| Ordered lists | `1. First item` `2. Second item` |
| Bulleted lists | `- First item` `- Second item` |
| Ordered lists | `1. First item` `2. Second item` |
| Bulleted lists | `- First item` `- Second item` |
| Headings | `# Heading level 1` and `## Heading level 2` |
| Partner variables | `@PartnerName` and `@PartnerEmail` |

### Images

You can also enrich your emails with images by clicking the **Insert image** button in the content editor.
You can also enrich your emails with images by clicking the **Insert image** button in the content editor.

<Frame>
<img src="/images/dub-partners/email-image.png" alt="Email image button" />
Expand All @@ -193,7 +197,10 @@
To add alternative text to images, hover over the added image and click the **Alt** button in the bottom-right corner. Then you can add a short description of the image for accessibility and SEO purposes.

<Frame>
<img src="/images/dub-partners/email-image-alt-text.png" alt="Email alt text" />
<img
src="/images/dub-partners/email-image-alt-text.png"
alt="Email alt text"
/>
</Frame>

## Email previews
Expand Down
18 changes: 18 additions & 0 deletions help/article/how-to-add-custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@

Once you have a custom domain, you can add it to your Dub workspace by following these steps:

1. Navigate to your workspace's Domains page – you can do that by clicking on the **Domains** link in the menu bar at the top of your workspace dashboard.

Check warning on line 40 in help/article/how-to-add-custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/how-to-add-custom-domain.mdx#L40

Did you really mean 'workspace's'?
2. Click on the **Add Domain** button.
3. Enter the domain you want to use and click **Add domain**.

Expand All @@ -59,6 +59,19 @@
/>
</Frame>

If your domain is hosted on **Vercel** or **Cloudflare**, you can skip manual DNS setup entirely. Click **Auto configure with Vercel** or **Auto configure with Cloudflare** on the domain configuration screen, approve the request on your provider's side, and the correct records (including TXT verification, if needed) will be added for you automatically.

Check warning on line 62 in help/article/how-to-add-custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/how-to-add-custom-domain.mdx#L62

Did you really mean 'Vercel'?

Check warning on line 62 in help/article/how-to-add-custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/how-to-add-custom-domain.mdx#L62

Did you really mean 'Vercel'?

<Frame>
<img
src="/images/help/domain-connect-auto-configure.png"
alt="Auto configure and Forward instructions buttons on the domain configuration screen"
/>
</Frame>

If you don't have access to your domain's DNS settings yourself, click **Forward instructions** to email the exact records needed straight to whoever manages your DNS (e.g. your IT team or domain registrar) - no manual copy/pasting required.

Otherwise, follow the manual steps below based on whether you're adding an apex domain or a subdomain.

## Step 2a: Adding an apex domain

If you're adding an apex domain (e.g. `example.com`), you'll need to add an `A` record with the following values:
Expand Down Expand Up @@ -98,8 +111,13 @@
being used on [Vercel](https://vercel.com/).
</Info>

Since we use Vercel as the DNS provider for Dub, you'll need to verify that you own the domain before you can add it to your Dub workspace.

Check warning on line 114 in help/article/how-to-add-custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/how-to-add-custom-domain.mdx#L114

Did you really mean 'Vercel'?

<Info>
If you used **Auto configure** in Step 2, this TXT record is added
automatically and you can skip the rest of this step.
</Info>

<Frame>
<img
src="https://assets.dub.co/cms/vercel-domain.png"
Expand Down
8 changes: 8 additions & 0 deletions help/article/using-cloudflare-domains.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,18 @@

We recommend using Cloudflare's DNS only mode for your custom domain. This makes sure that requests/clicks to your short links will always reach Dub directly instead of being served through Cloudflare – which can lead to [inaccurate analytics data](/help/article/incorrect-analytics-geolocation-data).

Configuring Cloudflare as DNS only is also better for redirect speeds, since you avoid having your users' requests get proxied through Cloudflare, which adds additional latency.

Check warning on line 13 in help/article/using-cloudflare-domains.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/using-cloudflare-domains.mdx#L13

Did you really mean 'proxied'?

To set this up, all you need to do is [set your domain's DNS records](/help/article/how-to-add-custom-domain#step-2-configure-your-domain) to point to Dub's servers and make sure that you're using the **DNS only** option on Cloudflare.

<Tip>
If you used **Auto configure with Cloudflare** ([Domain
Connect](/help/article/how-to-add-custom-domain#step-2-configure-your-domain))
when adding your domain, this is already done for you – the DNS record it
creates is automatically set to **DNS only**, so you can skip the manual
steps below.
</Tip>

1. Go to your Cloudflare dashboard and select your domain.
2. Click on the **DNS** tab on the sidebar menu.
3. Under **Records**, click on the **Edit** button.
Expand All @@ -24,7 +32,7 @@
<img src="https://assets.dub.co/help/cloudflare-without-proxy.png" alt="" />
</Frame>

This will make sure that the traffic to your domain is _not proxied through Cloudflare_ and is sent directly to Dub.

Check warning on line 35 in help/article/using-cloudflare-domains.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dub) - vale-spellcheck

help/article/using-cloudflare-domains.mdx#L35

Did you really mean 'proxied'?

## Using Cloudflare's Proxy

Expand Down
Binary file added images/help/domain-connect-auto-configure.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.