Custom HTML Redirect Pages
Detour allows you to fully customize the screens that users see when they click on your deep links or short links. This is especially useful for branding, loading states, and optimizing the app install experience.
There are two customizable HTML configurations available per App:
- Custom Redirect Page (Immediate Redirection / Fingerprinting)
- Custom Copy Link Page (iOS Clipboard Bypass Flow)
🛠️ Accessing Redirect Configuration
To customize your app's redirect pages:
- Log in to the Detour Dashboard.
- Select your mobile App from the sidebar.
- Open the Redirect Page settings tab.
1. Custom Redirect Page
The Custom Redirect Page is rendered in the user's browser during the immediate redirect flow (e.g. while the platform detects the device OS, creates a click event, or gathers deterministic fingerprint data).
- Best for: Adding custom loading spinners, displaying your app logo, or writing a short message like "Opening the app..."
- Technical Implementation: Detour serves this page inside a sandboxed iframe. For security and performance reasons, JavaScript execution is disabled, meaning only HTML markup and inline CSS styles are allowed.
2. Custom Copy Link Page
The Custom Copy Link Page is displayed exclusively to iOS users when the Copy Link flow is enabled on the App.
Modern iOS versions restrict access to the pasteboard (clipboard) from direct page redirects. To increase chance of probabilistic matching Detour prompts the user to copy the link and install the app.
Injected Dialog Overlay
When you customize the HTML for the Copy Link page:
- Your HTML serves as the background layout for the page.
- Detour automatically injects and displays the interactive Copy Link Dialog Box on top of your HTML.
- The dialog box contains buttons to copy the link, install the app, and open the app store.
Dashboard Settings
Because the dialog box is injected dynamically, you can configure its appearance directly in the dashboard:
- Banner Theme: Switch between Light and Dark themes to match your background.
- Banner Language: Choose from 11 supported languages (English, Polski, Español, Français, Deutsch, Italiano, Português, Nederlands, 日本語, 한국어, 中文) to automatically localize the copy-link prompt.
⚠️ Size and Security Constraints
To ensure safety and fast page loading, all custom HTML pages are subject to the following rules:
- Size Limit: The HTML content must not exceed 50 KB (51,200 characters).
- Scripts Blocked:
<script>tags and inline JavaScript (onload,onclick, etc.) are disabled. - Media Hosting: Any images, fonts, or external stylesheets used in the HTML must be hosted on an external, HTTPS-secured server (e.g. your CDN) and referenced via absolute URLs.
Support
Need help or found a bug? We are here to assist you! Join our developer community on Discord for quick support, or reach out via the Contact Form on our main homepage.