Importing and exporting redirects via CSV

Overview

SiteDetour supports bulk redirect management via CSV. You can import dozens or hundreds of redirects at once, and export your entire redirect list for backup, migration, or external reporting.

Exporting redirects

From Redirects, click Export in the top-right. A CSV file downloads containing every redirect in your organization, one row per path rule. Columns include:

• Source domain
• Source path
• Match type (Exact / Starts With)
• Target URL
• Redirect type (301 / 302 / 307)
• Path forwarding (on/off)
• Query forwarding (on/off)
• Team
• Tags

The export reflects the current state at download time. Re-export whenever you need a fresh backup.

Importing redirects

From Redirects, click Import Redirects. The modal prompts you to:

1. Download Sample File — grab the template CSV with the correct headers and an example row.
2. Fill in your data — one row per redirect path rule. Group rules for the same source domain into consecutive rows if you want them under one redirect record.
3. Upload your CSV.
4. Preview — SiteDetour parses the file and shows a dry-run preview of every row (created, updated, error). Correct any errors before confirming.
5. Submit — the redirects are created / updated atomically.

Required columns

The sample template is authoritative — always start from it. Minimum columns:

• source_domain
• path
• match_type (exact or starts_with)
• target_url
• redirect_type (301, 302, or 307)

Optional columns: forward_path, forward_query, team, tags (pipe-separated).

Plan caps

Import respects your plan's redirect cap. If the import would exceed it, the preview surfaces that and the submit is blocked. Buy additional capacity via Billing or trim the CSV.

Idempotency

Import will update existing redirects whose source_domain already exists in your account, rather than creating duplicates. To fully replace a redirect's path rules, delete the redirect first, then import.

Programmatic import

The same operation is available via API at POST /api/import-redirects. Useful for CI/CD-driven redirect management. Post the CSV as multipart/form-data. The response contains the dry-run preview; post again with ?confirm=1 to commit.

Migrating from another platform

Most redirect platforms can export to CSV. Transform columns to match SiteDetour's template (many providers use different column names) and import. For apex redirects, remember to also point DNS at SiteDetour before the redirects start resolving.

Next steps

• Creating a redirect
• API overview