rsnext/errors/get-initial-props-export.mdx

---
title: '`getInitialProps` Export Warning'
---

#### Why This Warning Occurred

You attempted to statically export your application via `output: 'export'` or `next export`, however, one or more of your pages uses `getInitialProps`.

Next.js discourages you to use `getInitialProps` in this scenario.

## Possible Ways to Fix It

Use `getStaticProps` instead for proper SSG support.

## Useful Links

- [`getStaticProps` Documentation](/docs/pages/building-your-application/data-fetching/get-static-props)
docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`---`
			title: '`getInitialProps` Export Warning'
			`---`
feat(next export): add warning if using getInitialProps (#37642) This PR builds on the work from @hattakdev (PR went stale: https://github.com/vercel/next.js/pull/14499) and adds a new `integration` test for the new warning. ## Bug - [x] Related issues linked using `fixes #number` - [x] Integration tests added - [x] Errors have helpful link attached, see `contributing.md` ![image](https://user-images.githubusercontent.com/3806031/173214117-f5159f3a-778c-4177-894d-78e7bb0c80e7.png) ## To run locally 1. `pnpm build` 2. `pnpm testonly test/integration/export-getInitialProps-warn/test/index.test.js` Fixes #13946 ## Notes <details> <summary>Click to toggle see</summary> I know the `contributing.md` doc said to avoid adding new tests to `integration`. It also said new tests should be written in TypeScript. I wasn't sure where to put the tests for this so I went with `integration`. I also didn't see many other tests written in TS in this part of the codebase so I stuck with `.js`. </details> Co-authored-by: JJ Kasper <22380829+ijjk@users.noreply.github.com> 2022-06-13 04:34:23 +02:00
			`#### Why This Warning Occurred`

chore(docs): update `next export` to `output: 'export'` (#47717) fix NEXT-927 ([link](https://linear.app/vercel/issue/NEXT-927)) 2023-03-31 04:04:23 +02:00			You attempted to statically export your application via `output: 'export'` or `next export`, however, one or more of your pages uses `getInitialProps`.
feat(next export): add warning if using getInitialProps (#37642) This PR builds on the work from @hattakdev (PR went stale: https://github.com/vercel/next.js/pull/14499) and adds a new `integration` test for the new warning. ## Bug - [x] Related issues linked using `fixes #number` - [x] Integration tests added - [x] Errors have helpful link attached, see `contributing.md` ![image](https://user-images.githubusercontent.com/3806031/173214117-f5159f3a-778c-4177-894d-78e7bb0c80e7.png) ## To run locally 1. `pnpm build` 2. `pnpm testonly test/integration/export-getInitialProps-warn/test/index.test.js` Fixes #13946 ## Notes <details> <summary>Click to toggle see</summary> I know the `contributing.md` doc said to avoid adding new tests to `integration`. It also said new tests should be written in TypeScript. I wasn't sure where to put the tests for this so I went with `integration`. I also didn't see many other tests written in TS in this part of the codebase so I stuck with `.js`. </details> Co-authored-by: JJ Kasper <22380829+ijjk@users.noreply.github.com> 2022-06-13 04:34:23 +02:00
			Next.js discourages you to use `getInitialProps` in this scenario.

docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`## Possible Ways to Fix It`
feat(next export): add warning if using getInitialProps (#37642) This PR builds on the work from @hattakdev (PR went stale: https://github.com/vercel/next.js/pull/14499) and adds a new `integration` test for the new warning. ## Bug - [x] Related issues linked using `fixes #number` - [x] Integration tests added - [x] Errors have helpful link attached, see `contributing.md` ![image](https://user-images.githubusercontent.com/3806031/173214117-f5159f3a-778c-4177-894d-78e7bb0c80e7.png) ## To run locally 1. `pnpm build` 2. `pnpm testonly test/integration/export-getInitialProps-warn/test/index.test.js` Fixes #13946 ## Notes <details> <summary>Click to toggle see</summary> I know the `contributing.md` doc said to avoid adding new tests to `integration`. It also said new tests should be written in TypeScript. I wasn't sure where to put the tests for this so I went with `integration`. I also didn't see many other tests written in TS in this part of the codebase so I stuck with `.js`. </details> Co-authored-by: JJ Kasper <22380829+ijjk@users.noreply.github.com> 2022-06-13 04:34:23 +02:00
chore(docs): update `next export` to `output: 'export'` (#47717) fix NEXT-927 ([link](https://linear.app/vercel/issue/NEXT-927)) 2023-03-31 04:04:23 +02:00			Use `getStaticProps` instead for proper SSG support.
feat(next export): add warning if using getInitialProps (#37642) This PR builds on the work from @hattakdev (PR went stale: https://github.com/vercel/next.js/pull/14499) and adds a new `integration` test for the new warning. ## Bug - [x] Related issues linked using `fixes #number` - [x] Integration tests added - [x] Errors have helpful link attached, see `contributing.md` ![image](https://user-images.githubusercontent.com/3806031/173214117-f5159f3a-778c-4177-894d-78e7bb0c80e7.png) ## To run locally 1. `pnpm build` 2. `pnpm testonly test/integration/export-getInitialProps-warn/test/index.test.js` Fixes #13946 ## Notes <details> <summary>Click to toggle see</summary> I know the `contributing.md` doc said to avoid adding new tests to `integration`. It also said new tests should be written in TypeScript. I wasn't sure where to put the tests for this so I went with `integration`. I also didn't see many other tests written in TS in this part of the codebase so I stuck with `.js`. </details> Co-authored-by: JJ Kasper <22380829+ijjk@users.noreply.github.com> 2022-06-13 04:34:23 +02:00
docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`## Useful Links`
feat(next export): add warning if using getInitialProps (#37642) This PR builds on the work from @hattakdev (PR went stale: https://github.com/vercel/next.js/pull/14499) and adds a new `integration` test for the new warning. ## Bug - [x] Related issues linked using `fixes #number` - [x] Integration tests added - [x] Errors have helpful link attached, see `contributing.md` ![image](https://user-images.githubusercontent.com/3806031/173214117-f5159f3a-778c-4177-894d-78e7bb0c80e7.png) ## To run locally 1. `pnpm build` 2. `pnpm testonly test/integration/export-getInitialProps-warn/test/index.test.js` Fixes #13946 ## Notes <details> <summary>Click to toggle see</summary> I know the `contributing.md` doc said to avoid adding new tests to `integration`. It also said new tests should be written in TypeScript. I wasn't sure where to put the tests for this so I went with `integration`. I also didn't see many other tests written in TS in this part of the codebase so I stuck with `.js`. </details> Co-authored-by: JJ Kasper <22380829+ijjk@users.noreply.github.com> 2022-06-13 04:34:23 +02:00
docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			- [`getStaticProps` Documentation](/docs/pages/building-your-application/data-fetching/get-static-props)