Dashboard Walkthrough
In the dashboard you create apps, configure link behavior, generate API keys, and read analytics. Every app belongs to an organization. The sections below describe each area, in the order you use them during setup.
Organizations
Section titled “Organizations”An organization is the top-level workspace in Detour. Each organization has its own:
- subdomain
- members
- apps and links
- analytics context
The subdomain is assigned at creation and becomes the host of every generated base link, unless you attach a custom domain. The switcher in the sidebar controls which organization you are working in.
Permissions are role-based.
-
Owner — the broadest scope.
Manages apps, short links, API keys, and team membership, and can assign every role (
owner,admin,member). Only an Owner can delete the organization. -
Admin — full day-to-day control.
Covers app setup, link configuration, short links, and API key rotation. Can invite and manage Admin and Member users, but not Owners, and cannot assign the Owner role or delete the organization.
-
Member — read-only.
Can inspect app setup and analytics, but cannot create or edit apps, manage short links, invite users, or perform any organization-level action.
If you are the sole owner of an organization, you cannot leave it until another owner is assigned. If that organization has other members, you also cannot delete your account until then.
The Apps view is the main dashboard view. It lists every app in the selected organization.
Owners and Admins can create, rename, and delete apps. Every member can copy an app’s link. The number of apps you can create depends on your plan, and the Free plan allows one. See Billing & Payments.
Base link
Section titled “Base link”When you create an app, Detour generates its App ID, its publishable API key and its base link:
https://<subdomain>.godetour.link/<app_hash>You cannot change the base link. For campaign variants, create short links or add URL parameters to it.
App details
Section titled “App details”An app opens in a view with four tabs. A setup progress widget stays visible until the app has at least one mobile platform configured and a Redirect URL for web fallback.
Link settings
Section titled “Link settings”- Your app link — the read-only base URL, with a QR code and editable link metadata (title and description, Open Graph, Twitter/X).
- Redirect URL for web fallback — the URL desktop and non-app traffic is redirected to. Query parameters can be forwarded in full, selectively, or not at all.
- Short links — campaign and channel variants, with QR codes.
- Matching configuration — threshold and time window. See Matching.
The tab also shows app-level Link stats: Clicks, Installs via link, and Fallbacks.
App configuration
Section titled “App configuration”The iOS and Android cards each have an edit mode and a generated integration snippet. For the fields and where to find their values, see Getting Started.
Saving regenerates the snippets with the current link host and app-specific paths. If your organization uses a custom domain, the snippets carry that host instead.
Redirect page
Section titled “Redirect page”Three tabs, one per screen a user can see while a link resolves:
- Redirect Page — shown during the immediate redirect.
- Copy Link Page — the background of the iOS copy-link flow.
- App Preview — an optional interstitial shown to mobile visitors before the store redirect, which they continue from with a tap. Off by default, and built either from a template or, on Scale and above, from your own HTML.
Custom HTML supports HTML and inline CSS only, and scripts are disabled. Detour injects the copy-link dialog and the App Preview Continue button on top of your markup, so their appearance is set here rather than in the HTML. See Custom HTML Redirects.
API configuration
Section titled “API configuration”Each app has two keys.
-
Publishable API Key (with the App ID) — used by the SDK.
Generate new key deactivates the previous one and creates a replacement.
-
Secret API Key — used for server-to-server calls to the Platform API.
It is shown only once at generation time, because Detour stores a hash rather than the key. Regenerating revokes the previous secret immediately.
Treat both as app credentials. Rotate at the first suspicion of exposure and update every client. Never ship the secret key in client-side code or a mobile app.
Analytics
Section titled “Analytics”Analytics pages are app-scoped, and all of them share the same filters: app,
platform (all, ios, android), and date range.
Overview is available on all plans. Links and Events require a paid plan. See Billing & Payments.
For metrics, event logging, and the retention model, see Analytics.
Smart banners
Section titled “Smart banners”In Smart Banners you configure the app banner shown on your own website and copy the script tag that adds it to the site.
Available on Starter and above. See Smart Banners.
Webhooks
Section titled “Webhooks”Webhooks deliver an app’s analytics data to an HTTPS endpoint on a recurring schedule (daily, weekly, or monthly). Webhooks are a paid feature and the number of active webhooks depends on your plan. See Webhooks for setup, payload format, and signature verification.
Organization settings
Section titled “Organization settings”Invite members, change roles, and remove users, following the role rules above.
Billing
Section titled “Billing”The organization’s plan, usage, payment method, and invoices. For plans, limits, pay-as-you-go, and the full payment lifecycle, see Billing & Payments.
Account settings
Section titled “Account settings”Change your password or email, or delete your account.