Docs: Missing information about redirecting

Feature request

Is your feature request related to a problem? Please describe.

I’ve been looking through the docs and I can’t seem to find any information on how to redirect. There used to be a wiki page but that got deleted, and so the only information I could find are in GitHub issues.

1. So it seems okay to redirect in getInitialProps, however that is being deprecated in favor of getServerSideProps. Is it safe to redirect in there?
2. However, @Timer said that you shouldn’t redirect in getInitialProps using the client-side router (here). Which makes the method that was mentioned in the original wiki page incorrect.

So what is the best way to redirect in the current version of next? Looking at zeit.co it looks like its being done in getInitialProps but I can’t be sure. If I had to venture a guess you should do it in getServerSideProps and useEffect in the function for client-side redirection.

Describe the solution you’d like

A page that describes the recommended way to redirect on the server-side and/or client side.

Describe alternatives you’ve considered

N/A

Additional context

N/A

[timneutkens]

Opened a RFC for redirecting here: #14890

[lachlanjc]

There’s docs for this at the end of this section: https://nextjs.org/docs/basic-features/data-fetching#getstaticprops-static-generation

Can we close?