diff --git a/docs/api-reference/next.config.js/redirects.md b/docs/api-reference/next.config.js/redirects.md
index d1eb3929e8500..02b9771af56e5 100644
--- a/docs/api-reference/next.config.js/redirects.md
+++ b/docs/api-reference/next.config.js/redirects.md
@@ -6,6 +6,13 @@ description: Add redirects to your Next.js app.
> This feature was introduced in [Next.js 9.5](https://nextjs.org/blog/next-9-5) and up. If you’re using older versions of Next.js, please upgrade before trying it out.
+
+ Examples
+
+
+
Redirects allow you to redirect an incoming request path to a different destination path.
Redirects are only available on the Node.js environment and do not affect client-side routing.
diff --git a/examples/redirects/.gitignore b/examples/redirects/.gitignore
new file mode 100644
index 0000000000000..1437c53f70bc2
--- /dev/null
+++ b/examples/redirects/.gitignore
@@ -0,0 +1,34 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# vercel
+.vercel
diff --git a/examples/redirects/README.md b/examples/redirects/README.md
new file mode 100644
index 0000000000000..bda006d6002d8
--- /dev/null
+++ b/examples/redirects/README.md
@@ -0,0 +1,23 @@
+# Redirects Example
+
+This example shows how to use [redirects in Next.js](https://nextjs.org/docs/api-reference/next.config.js/redirects) to redirect an incoming request path to a different destination path.
+
+The index page ([`pages/index.js`](pages/index.js)) has a list of links that match the redirects defined in [`next.config.js`](next.config.js). Run or deploy the app to see how it works!
+
+## Deploy your own
+
+Deploy the example using [Vercel](https://vercel.com):
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/import/project?template=https://github.com/vercel/next.js/tree/canary/examples/redirects)
+
+## How to use
+
+Execute [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app) with [npm](https://docs.npmjs.com/cli/init) or [Yarn](https://yarnpkg.com/lang/en/docs/cli/create/) to bootstrap the example:
+
+```bash
+npx create-next-app --example redirects redirects-app
+# or
+yarn create next-app --example redirects redirects-app
+```
+
+Deploy it to the cloud with [Vercel](https://vercel.com/import?filter=next.js&utm_source=github&utm_medium=readme&utm_campaign=next-example) ([Documentation](https://nextjs.org/docs/deployment)).
diff --git a/examples/redirects/next.config.js b/examples/redirects/next.config.js
new file mode 100644
index 0000000000000..acccfa8d7edf4
--- /dev/null
+++ b/examples/redirects/next.config.js
@@ -0,0 +1,34 @@
+module.exports = {
+ // Uncomment the line below to enable basePath, pages and
+ // redirects will then have a path prefix (`/app` in this case)
+ //
+ // basePath: '/app',
+
+ async redirects() {
+ return [
+ {
+ source: '/team',
+ destination: '/about',
+ permanent: false,
+ },
+ // Path Matching - will match `/old-blog/a`, but not `/old-blog/a/b`
+ {
+ source: '/old-blog/:slug',
+ destination: '/news/:slug',
+ permanent: false,
+ },
+ // Wildcard Path Matching - will match `/blog/a` and `/blog/a/b`
+ {
+ source: '/blog/:slug*',
+ destination: '/news/:slug*',
+ permanent: false,
+ },
+ // Regex Path Matching - The regex below will match `/post/123` but not `/post/abc`
+ {
+ source: '/post/:slug*',
+ destination: '/news/:slug*',
+ permanent: false,
+ },
+ ]
+ },
+}
diff --git a/examples/redirects/package.json b/examples/redirects/package.json
new file mode 100644
index 0000000000000..0d00e77f35f5d
--- /dev/null
+++ b/examples/redirects/package.json
@@ -0,0 +1,14 @@
+{
+ "name": "redirects",
+ "version": "1.0.0",
+ "scripts": {
+ "dev": "next dev",
+ "build": "next build",
+ "start": "next start"
+ },
+ "dependencies": {
+ "next": "latest",
+ "react": "^16.13.1",
+ "react-dom": "^16.13.1"
+ }
+}
diff --git a/examples/redirects/pages/about.js b/examples/redirects/pages/about.js
new file mode 100644
index 0000000000000..b58d38f59dfe1
--- /dev/null
+++ b/examples/redirects/pages/about.js
@@ -0,0 +1,16 @@
+import Link from 'next/link'
+import styles from '../styles.module.css'
+
+export default function About() {
+ return (
+