# 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 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](https://detour.swmansion.com/docs/platform/advanced/custom-domain). The switcher in the sidebar controls which organization you are working in. ### Roles 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. ## Apps 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](https://detour.swmansion.com/docs/platform/fundamentals/billing). ### Base link When you create an app, Detour generates its App ID, its publishable API key and its base link: ```text https://.godetour.link/ ``` You cannot change the base link. For campaign variants, create short links or add URL parameters to it. :::note[Create one app per environment] To keep staging and production apart, create a separate app for each. Each app has its own credentials. ::: ## 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 - **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](https://detour.swmansion.com/docs/platform/architecture/matching). The tab also shows app-level **Link stats**: Clicks, Installs via link, and Fallbacks. ### 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](https://detour.swmansion.com/docs/platform/fundamentals/getting-started#app-configuration). Saving regenerates the snippets with the current link host and app-specific paths. If your organization uses a [custom domain](https://detour.swmansion.com/docs/platform/advanced/custom-domain), the snippets carry that host instead. ### 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](https://detour.swmansion.com/docs/platform/advanced/custom-html-redirects). ### 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](https://detour.swmansion.com/docs/platform/advanced/api-management). 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 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](https://detour.swmansion.com/docs/platform/fundamentals/billing). For metrics, event logging, and the retention model, see [Analytics](https://detour.swmansion.com/docs/platform/fundamentals/analytics). ## 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](https://detour.swmansion.com/docs/platform/advanced/smart-banners). ## 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](https://detour.swmansion.com/docs/platform/fundamentals/webhooks) for setup, payload format, and signature verification. ## Organization settings Invite members, change roles, and remove users, following the [role rules](#roles) above. ## 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](https://detour.swmansion.com/docs/platform/fundamentals/billing). ## Account settings Change your password or email, or delete your account. ## Related pages [Getting Started with Detour](https://detour.swmansion.com/docs/platform/fundamentals/getting-started/) [Analytics](https://detour.swmansion.com/docs/platform/fundamentals/analytics/) [Billing & Payments](https://detour.swmansion.com/docs/platform/fundamentals/billing/) [Webhooks](https://detour.swmansion.com/docs/platform/fundamentals/webhooks/) [Matching](https://detour.swmansion.com/docs/platform/architecture/matching/) [Universal Links & App Links](https://detour.swmansion.com/docs/platform/fundamentals/universal-app-links/)