Dashboard Walkthrough
This page explains the main areas of the Detour dashboard and how they work together in a typical setup flow.
Organizations
Detour is organized around organizations. Each organization has its own subdomain, members, apps, links, and analytics context. When you create an organization, Detour assigns a unique subdomain, and generated base links use that host (unless you attach a custom domain). In daily use, the organization switcher in the sidebar controls which workspace you are currently operating in.
Permissions are role-based. Owners have full control over apps, members, API keys, and destructive organization actions. Admins can manage apps and short links, and can manage invitations and roles for Admin/Member users, but they cannot manage Owners or delete the organization. Members have read-only access to configuration and analytics and cannot perform management actions.
Role details
Owner
Owners have the broadest permission scope in the organization. They can manage applications, short links, API keys, and team membership, including assigning all roles (owner, admin, member). They can also delete the organization.
Admin
Admins can fully manage day-to-day application work, including app setup, link configuration, short links, and API key rotation. They can invite and manage Admin/Member users, but they cannot manage Owner users, cannot assign the Owner role, and cannot delete the organization.
Member
Members have read-only access to dashboard data and configuration views. They can inspect app setup and analytics, but they cannot create or edit apps, manage short links, invite users, or perform organization-level management actions.
Detour also enforces owner safety rules. If you are the sole owner of an organization, you cannot leave it until another owner is assigned.
Apps
The main dashboard view (Apps) lists all apps in the selected organization. Each app card includes the app name, base link URL, platform state indicators (iOS/Android), and action controls. Owners and Admins can create new apps from this view, and can rename or delete existing apps. All users can copy the app link.
When a new app is created, Detour provisions app-level resources used across the rest of the UI: app identity, publishable key, and the default deferred-link base. The immutable base pattern is:
https://<subdomain>.godetour.link/<app_hash>
You should treat this base as fixed and only build variants using short links and URL parameters. For environment isolation (for example staging vs production), create separate app entries with separate credentials.
App details
Opening an app takes you to a three-tab workspace:
- Link settings
- App configuration
- API configuration
Detour shows a setup progress widget until two core requirements are completed: at least one mobile platform configuration and a fallback Redirect URL.
Link settings
Link settings is where link behavior is configured end-to-end. The Your app link section gives you the read-only base URL plus operational tools such as copy, QR code preview, and metadata editing (title/description plus Open Graph and Twitter/X metadata).
The Redirect URL for web fallback section defines where desktop/non-app traffic should land. You can also choose how query parameters are forwarded: pass none, pass all, or pass only selected keys.
The Short links section is used for campaign and channel variants. You can create, edit, and delete short links and generate QR codes for them. Because Android App Link intent filters are path-based, adding or removing short-link hashes requires keeping Android integration snippet paths in sync.
You also get app-level Link stats in this tab: Clicks, Installs via link, and Fallbacks. Finally, Matching configuration lets you tune matching behavior through threshold and time window parameters. For more details, see Matching.
App configuration
App configuration contains separate iOS and Android setup cards, each with edit mode and generated integration snippets.
On iOS, Detour expects Bundle ID, Team ID, and App Store ID, with optional copy-link flow support. On Android, Detour expects package name and signing certificate fingerprints (production and/or debug), with validation that at least one certificate is provided.
After saving, integration code snippets are generated with the current link host and app-specific path values. If your organization uses a custom domain, snippets are generated for that custom host. For more details, see Custom domain.
Links behavior (runtime flow)
All links generated in Detour are processed according to install state and OS capabilities. If the app is not installed, Detour handles click recording, store redirection, and post-install matching. If the app is installed, links can open the app directly through Universal Links / App Links when host association is configured and verified.
In cases where verified link delivery is not available in a given runtime context, app-side custom scheme handling can still be used as a fallback path, but this requires correct app configuration on each platform.
For more details about hosted association files, Universal/App Links, and custom scheme requirements, see Universal Links & App Links.
API configuration and key security
Each app has a dedicated Publishable API Key and App ID visible in API configuration. The key can be revealed/masked and copied from the UI. Rotating the key (Generate new key) deactivates the previous active key and creates a new one for the same app.
From an operational perspective, keys should be treated as app credentials. If you suspect exposure, rotate immediately and update app configuration in all clients.
Organization settings
Organization Settings contains team and lifecycle controls. You can invite members, review active and invited users, change roles (subject to role rules), resend or cancel invitations, and remove users. Users can also leave an organization when ownership constraints are satisfied.
Organization deletion is available only to Owners.
Account settings
Account settings include password change, email change, and account deletion. Account deletion is guarded by ownership constraints: if you are the sole owner of multi-member organizations, you must assign another owner first.
Analytics
Analytics pages are app-scoped and filterable by app, platform (all, ios, android), and date range (presets or custom window).
The Overview page aggregates key performance signals, including link trend, install attribution split (organic vs non-organic), top events, and retention comparison. The Links page provides path/parameter breakdown for link performance with deeper filtering. The Events page provides event timeline and totals, with drill-down into occurrence-level data.
For more details on metrics, event logging, and retention model, see Analytics.