Migrate from Dub.co to Elido

Dub and Elido share a similar data model — links, tags, folders, workspaces — which makes migration straightforward. The importer pulls every link via Dub's REST API and recreates them in Elido, preserving structure and the click count at the moment of migration.

Before you start#

• A Dub.co account with a read-scoped API token.
• An Elido workspace. If you have custom domains in Dub, add them to Elido first before running the import so you can map them.

Step 1 — Generate a Dub API token#

1. Log into Dub.
2. Go to Settings → Tokens → Create new token.
3. Select Read scope. You don't need write access.
4. Copy the token.

Dub's read-scoped token lets Elido list all your links and metadata. It can't create or delete anything in Dub. Revoke it after import from the same settings page.

Step 2 — Open the migration wizard in Elido#

1. Go to Dashboard → Integrations → Dub Migration, or click Start migration from the integrations page.
2. Paste the Dub API token. Click Connect.
3. Elido lists every Dub project (workspace) your token can see. Select which ones to import.

Step 3 — Map domains#

Dub supports custom domains. For each one, map it to an Elido domain or a shared Elido domain (s.elido.me). Dub's default domain dub.sh maps to s.elido.me by default.

Step 4 — Run the import#

Click Start import. The worker paginates GET /api/links and creates Elido links:

• Slug — preserved if available in Elido; suffixed if taken.
• Tags — matched by name; created fresh if they don't exist.
• Folders — mapped to Elido folder structure.
• Click count — snapshotted at the moment the import runs. Elido stores this as a migrated_clicks field visible in the link detail view.

Import time: under 5 minutes for up to 5,000 links. An email arrives on completion.

What gets imported#

• Destination URL, slug.
• Tags and folders (structure preserved).
• Click count snapshot.
• Creation date.
• Expiry date (if set).

What doesn't migrate#

• Per-click event data — country, device, referrer breakdowns from before migration. Only the total count is snapshotted. Granular data starts accumulating in Elido from cutover.
• Conversion events — Dub conversion tracking data isn't exportable via API.
• UTM templates — Recreate in Elido's link settings if you use saved UTM presets.
• QR codes — Regenerate from Elido's link detail page. They're auto-generated, so it's one click per link.

After the import#

Once links are in Elido:

1. Update your DNS if you're moving custom domains — point them to Elido's edge (see Add a custom domain).
2. Update any hardcoded short URLs in emails, ad campaigns, and social profiles that still point to Dub links. Dub links will keep redirecting as long as Dub's service is running, but you're now on Elido's analytics.
3. Cancel your Dub subscription if you no longer need it.

Troubleshooting#

"Unauthorized" on connect — The token is invalid or expired. Dub tokens don't expire by default, but they can be revoked. Generate a new one.

Projects not listed after connect — The token was generated for a specific workspace. Generate a token under the account owner's profile to see all workspaces.

Slug conflicts in the import log — A link with that slug already exists in your Elido workspace. The importer suffixes with -dub and logs both versions. If you want the clean slug, delete the Elido version first and re-run.

Click count showing 0 instead of the snapshot — The migrated_clicks field shows in the link detail view, not the main list. Check Dashboard → Links → [link slug] → Details tab.