Changelog

We've made a few DX (Developer Experience) improvements to our API:

1. New externalId prop for simplified link management

You can now set an externalId prop when creating a short link to associate it with a link in your database. This lets you use your own link ID to retrieve or update the link, which eliminates the need to store the Dub-generated ID in your database.

Read this blog post to see it in action.

2. Arbitrary start and end parameters for analytics endpoints

All our analytics endpoints now support passing arbitrary start and end query parameters for retrieving analytics data within a specific time range. We will be adding support for this in our dashboard soon, but you can start using it now with the API.

Check out the API and SDK docs to learn more.

3. New upsert method for efficient link creation

We added a new dub.links.upsert method for you to create or update a link in one API call. With upsert, you can shorten a URL once and all subsequent calls with that URL will return the same short link. This helps you optimize your links usage by not creating duplicate short links.

Check out the API and SDK docs to learn more.

We've added an in-app help portal to help you with any questions you may have about Dub.

You can access the help portal by clicking on the ? button at the top of the left sidebar.

The help portal contains articles on how to use Dub, answers to frequently asked questions, and a way to easily contact our support team if you can't find the answer you're looking for.

You can now set a custom expiration URL for your links. This allows you to redirect users to a specific page once the link has expired.

Alternatively, you can also set a custom expiration URL on a domain-level. This means that all links created under the domain will redirect to the custom expiration URL once they have expired.

You can now export your link analytics on Dub.co to a CSV file.

This is a great way to analyze your link data in a spreadsheet or import it into another business intelligence (BI) tool like Tableau or Power BI.

Learn how to export your link analytics to a CSV file in our help center article.

Workspaces are a new way to organize your links and collaborate with your team on Dub.

They replace the old concept of "Projects" on Dub and are designed for teams at companies of all sizes. You can create a workspace for your team and:

• Invite your teammates to collaborate with you
• Create tags to better manage your links
• Set up SAML/SSO (Enterprise only)

If you're a Dub API user, here are some changes you should be aware of:

• The projectSlug query parameter has now been replaced by workspaceId, which can be found under your Workspace's Settings tab. We will still support the projectSlug query parameter for backward compatibility, but we recommend using workspaceId for new integrations.

Short links on Dub.co now redirect with a 302 status code by default.

On the other hand, for root domain links, Dub uses 301 redirects for maximum SEO value.

Learn more about the differences between 301 and 302 redirects in our latest blog post.

You can now invite your teammates to join your workspace on Dub.co via an invite link.

This is especially useful if you have a large team and want to invite multiple people at once. You can also use this feature to invite people who are not yet on Dub.co.

Learn more about workspace invite links.

Unlike other link management platforms, Dub.co lets you update the destination URL for your short links as many time as you want.

Now, you can see the historical analytics for each destination URL variation for a Dub.co short link – sorted by their respective number of clicks.

You can now safely edit your short links on Dub.co and they will retain their analytics history.

In the past, editing a short link (e.g. d.to/abc → d.to/xyz) would reset the analytics history for the link, which wasn't ideal. Well, not anymore!

This is helpful when you need to update a link for any reason (e.g. company rebrands). Analytics for the link will now be preserved and will continue to accumulate from where it left off.

You can now sign in to your Dub.co account with GitHub.

If you have an existing Dub.co account with an email address that matches your GitHub account, you can sign in with either method moving forward.