Redirect Helper Extension

Redirect Helper is an extension that validates and automatically repairs malformed redirect URLs before they fire. Install it once and it runs on every redirect button action across all your campaigns.

What you'll learn

• How Redirect Helper validates and repairs malformed redirect URLs

• Which URL types are supported (https, http, tel, mailto, sms, and relative paths)

• How redirects behave in Preview and QA mode vs. live

• How to use the public API for custom redirect validation

What it does

Redirect Helper runs on every button redirect action in your campaign. It validates the URL and, when possible, repairs malformed or incomplete URLs before the redirect fires.

Without this extension, a redirect URL like /products/shoes (a relative path) would fail or behave unexpectedly because Digioh's core redirect handler expects absolute URLs . Redirect Helper detects these cases and converts them to fully qualified URLs at runtime.

In Preview and QA mode (boxqamode), Redirect Helper intercepts all redirects and displays a clickable link in the notification overlay instead — so you can test redirect behaviour without leaving the preview.

How to install

1. Go to Account → Extension|
   

2. Find Redirect Helper under the Miscellaneous Tab and click Install 
   

3. Click Publish Extension.

The extension automatically activates for all campaigns. No campaign-level configuration is required.

Supported URL formats

Redirect Helper validates and handles the following URL types:

• https:// and http:// — standard web URLs, validated and used as-is

• Relative paths starting with / — automatically prefixed with the site's protocol and hostname

• Protocol-relative URLs starting with // — prefixed with the current page's protocol

• tel: — telephone links (e.g., tel:+15551234567)

• mailto: — email links

• sms: — SMS links with optional body parameter

For tel:, mailto:, and sms: URLs, Redirect Helper bypasses Digioh's standard redirect handler and performs a direct browser-native redirect to avoid compatibility issues.

Automatic URL repair

When a redirect URL is malformed, Redirect Helper attempts to repair it before failing. The repair logic covers three cases:

• Relative paths like /products/shoes are converted to absolute URLs using the current site's hostname.

• Protocol-relative URLs like //example.com/page get the current page's protocol prepended.

• URLs where Digioh's core has erroneously prefixed http:// have the prefix stripped and the URL re-evaluated.

If the URL cannot be validated or repaired, Redirect Helper logs an error in the notification overlay and blocks the redirect.

Preview and QA mode behavior

Note: In Preview mode (/Box/Preview) and when boxqamode is active, redirects are never executed. Redirect Helper displays a clickable link in the notification overlay instead, so you can confirm the redirect destination without leaving the preview.

The notification shows the resolved URL after any repair has been applied, so you can verify the final destination before going live. This prevents accidental navigation away from the Design Editor during testing.

Important notes

Important: If both Redirect Helper and a native Digioh redirect button are configured, Redirect Helper runs first and can block the redirect if the URL is invalid. Always verify redirect URLs in QA mode before publishing.

• Redirect Helper is always on. It applies to every redirect button in every campaign once installed.

• Merge tags in redirect URLs are supported. The extension strips merge tags before validating the URL structure.

Public API: boxapi.repairUrl(url)

The extension exposes a utility function for use in custom JS snippets in the same campaig:

// Returns the original URL, a repaired URL, or null if unrepairableconst repaired = boxapi.repairUrl(someUrl);if (repaired) {    // URL is valid or was repaired} else {    // URL is invalid and could not be repaired}

Need help with Redirect Helper? Reach out to support@digioh.com — we're happy to dig in.