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

# Redirect Rules

> Control where users go after authentication events like login, signup, and password reset

Redirect Rules let you decide where users land after key moments in their journey — like after they log in, sign up, reset their password, or get denied access to protected content.

## What are Redirect Rules?

By default, Gately handles redirects automatically. But with Redirect Rules, you can customise exactly where users go based on what just happened. For example:

* Send new signups to an onboarding page
* Redirect users to a specific dashboard after login
* Show a custom "upgrade required" page when someone tries to access gated content

***

## Creating a Redirect Rule

<Steps>
  <Step title="Go to Redirect Rules">
    In your sidebar, under **Authentication**, click **Redirect Rules**.
  </Step>

  <Step title="Click New Rule">
    Click **New Rule** in the top right.
  </Step>

  <Step title="Choose a trigger event">
    Select the event that should trigger this redirect — for example, **Login** or **Signup**.
  </Step>

  <Step title="Set the destination URL">
    Enter the URL you want to redirect users to after this event.
  </Step>

  <Step title="Save">
    Click **Save**. The rule is now active.
  </Step>
</Steps>

***

## Trigger Events

| Event                     | When it fires                                                   |
| ------------------------- | --------------------------------------------------------------- |
| **Login**                 | A member logs in successfully                                   |
| **Signup**                | A new member creates an account                                 |
| **OAuth Login**           | A member logs in via a social provider                          |
| **OAuth Signup**          | A new member signs up via a social provider                     |
| **Magic Link Login**      | A member logs in via a magic link                               |
| **Password Reset**        | A member requests a password reset                              |
| **Password Updated**      | A member successfully updates their password                    |
| **Access Denied**         | A member tries to access content they don't have permission for |
| **Subscription Required** | A member tries to access content that requires a paid plan      |
| **Plan Upgrade Required** | A member's current plan doesn't include the content             |
| **Invitation Accepted**   | A member accepts an invitation to join                          |
| **Email Verified**        | A member verifies their email address                           |
| **Logout**                | A member logs out                                               |

***

## Tips

<AccordionGroup>
  <Accordion title="Onboarding flow">
    Set a **Signup** redirect to your onboarding page so new members are guided through setup right after they create their account.
  </Accordion>

  <Accordion title="Upgrade prompts">
    Use **Subscription Required** and **Plan Upgrade Required** redirects to send users to a pricing or upgrade page instead of a generic error.
  </Accordion>

  <Accordion title="Post-login destination">
    Redirect members to their personal dashboard or a welcome-back page after **Login** to create a more polished experience.
  </Accordion>
</AccordionGroup>