> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting instant redirect pages

> Fix redirect pages that are not working correctly in HoopAI platform funnels, including URL format issues, timing problems, conditional redirects, and mobile compatibility.

Instant redirect pages in the HoopAI platform let you automatically send visitors from one funnel page to another URL. When redirects fail, visitors see a blank page or stay stuck on the current step. This guide covers the most common redirect issues and how to resolve them.

***

## Redirect URL format

An incorrectly formatted URL is the most common reason a redirect page does not work.

* Always include the full URL with protocol: `https://example.com/page`
* Do not use relative paths like `/thank-you` — use the complete URL
* Remove any trailing spaces or line breaks from the URL field
* Avoid special characters that are not URL-encoded

<Warning>
  URLs without `https://` or `http://` will not redirect. Hoop does not automatically prepend the protocol to redirect URLs.
</Warning>

***

## Timing issues

Redirect pages execute immediately by default, but certain configurations can cause delays or prevent the redirect from firing.

<Steps>
  <Step title="Check for conflicting scripts">
    If you have added custom JavaScript to the page through **Settings > Custom Code**, a script error can block the redirect from executing. Remove custom scripts temporarily to test.
  </Step>

  <Step title="Verify page load sequence">
    If the redirect page is part of a multi-step funnel, confirm the previous step is correctly configured to advance to the redirect page. A misconfigured form action can skip or bypass the redirect.
  </Step>

  <Step title="Test in an incognito window">
    Browser extensions and cached data can interfere with redirects. Open the funnel in an incognito or private browsing window to rule out browser-side issues.
  </Step>
</Steps>

***

## Conditional redirects

If you are using conditional logic to redirect visitors to different URLs based on form input or contact data, incorrect configuration can send visitors to the wrong destination or nowhere at all.

| Issue                           | Cause                                  | Fix                                                                              |
| ------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------- |
| All visitors go to the same URL | Conditions are not evaluated correctly | Check that your conditional logic uses the correct field and comparison operator |
| No redirect happens             | No condition matches                   | Add a default/fallback redirect URL for visitors who do not match any condition  |
| Wrong redirect destination      | Conditions overlap                     | Reorder conditions so the most specific rule is evaluated first                  |

<Tip>
  Test each conditional path by submitting the funnel with different data values. Verify that each path redirects to the expected URL.
</Tip>

***

## Tracking pixels and redirect timing

If you have tracking pixels (Facebook Pixel, Google Analytics, or similar) on the redirect page, the redirect may fire before the pixel has time to load and send its event.

<Steps>
  <Step title="Add a brief delay">
    Configure a 2 to 3-second delay on the redirect to give tracking pixels time to fire. In the redirect page settings, set the **Redirect Delay** value if available.
  </Step>

  <Step title="Move pixels to the destination page">
    If a delay is not acceptable for user experience, place your conversion tracking pixel on the destination page instead of the redirect page.
  </Step>

  <Step title="Use server-side tracking">
    For the most reliable tracking, use server-side conversion APIs (such as Facebook Conversions API) instead of client-side pixels. These are not affected by redirect timing.
  </Step>
</Steps>

<Note>
  A redirect delay of more than 5 seconds can cause visitors to leave before reaching the destination. Keep delays as short as possible.
</Note>

***

## Mobile redirect issues

Redirects may behave differently on mobile devices compared to desktop browsers.

* **In-app browsers**: Links opened from Facebook, Instagram, or email apps use in-app browsers that can block or delay redirects. Test your funnel by opening it within these apps
* **Pop-up blockers**: Some mobile browsers treat JavaScript-based redirects as pop-ups and block them. Use server-side redirects when possible
* **Slow connections**: On slower mobile networks, the redirect page may take longer to load, delaying the redirect. Ensure the redirect page has minimal content and no large assets

***

## URL parameter passing

When you redirect visitors, you may need to carry URL parameters (UTM tags, tracking IDs, or form data) from the funnel page to the destination URL.

<Steps>
  <Step title="Enable parameter forwarding">
    In the redirect page settings, enable the **Pass URL Parameters** option if available. This appends all incoming URL parameters to the redirect destination.
  </Step>

  <Step title="Manually append parameters">
    If automatic forwarding is not available, add the parameters directly to your redirect URL. For example: `https://example.com/thank-you?utm_source=facebook&utm_medium=cpc`
  </Step>

  <Step title="Test parameter passing">
    Visit your funnel page with test parameters (e.g., `?test=123`) and verify they appear in the destination URL after the redirect completes.
  </Step>
</Steps>

***

## FAQs

<AccordionGroup>
  <Accordion title="Can I redirect to an external website outside of Hoop?">
    Yes. Redirect pages can point to any valid URL, including external websites, payment pages, or booking calendars hosted outside of Hoop.
  </Accordion>

  <Accordion title="Why does my redirect work on desktop but not on mobile?">
    In-app browsers (Facebook, Instagram, Gmail) handle redirects differently than standard browsers. Test the full flow from within the app where your audience will click the link.
  </Accordion>

  <Accordion title="Does the redirect page affect my funnel analytics?">
    Yes. The redirect page is counted as a page view in your funnel analytics. If you are tracking conversion rates, account for the redirect step in your funnel calculations.
  </Accordion>
</AccordionGroup>