next
Version:
The React Framework
73 lines (48 loc) • 3.44 kB
Markdown
---
title: devIndicators
description: Configuration options for the on-screen indicator that gives context about the current route you're viewing during development.
---
`devIndicators` allows you to configure the on-screen indicator that gives context about the current route you're viewing during development.
Open `next.config.ts` and set `position` to choose where the indicator renders. The default is `bottom-left`.
```ts filename="next.config.ts"
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
devIndicators: {
position: 'bottom-right', // 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right'
},
}
export default nextConfig
```
To hide the indicator entirely, set `devIndicators` to `false`. Next.js will still surface any compile or runtime errors that were encountered.
```ts filename="next.config.ts"
const nextConfig: NextConfig = {
devIndicators: false,
}
export default nextConfig
```
## Troubleshooting
### Indicator not marking a route as static
If you expect a route to be static and the indicator has marked it as dynamic, it's likely the route has opted out of prerendering.
You can confirm if a route is [prerendered](/docs/app/glossary#prerendering) or [dynamically rendered](/docs/app/glossary#dynamic-rendering) by building your application using `next build --debug`, and checking the output in your terminal. Static (or prerendered) routes will display a `○` symbol, whereas dynamic routes will display a `ƒ` symbol. For example:
```bash filename="Build Output"
Route (app)
┌ ○ /_not-found
└ ƒ /products/[id]
○ (Static) prerendered as static content
ƒ (Dynamic) server-rendered on demand
```
<AppOnly>
There are two reasons a route might opt out of prerendering:
- The presence of [Request-time APIs](/docs/app/glossary#request-time-apis) which rely on request information.
- An [uncached data request](/docs/app/getting-started/fetching-data), like a call to an ORM or database driver.
Check your route for any of these conditions, and if you are not able to statically render the route, then consider using [`loading.js`](/docs/app/api-reference/file-conventions/loading) or [`<Suspense />`](https://react.dev/reference/react/Suspense) to leverage [streaming](/docs/app/getting-started/linking-and-navigating#streaming).
</AppOnly>
<PagesOnly>
When exporting [`getServerSideProps`](/docs/pages/building-your-application/data-fetching/get-server-side-props) or [`getInitialProps`](/docs/pages/api-reference/functions/get-initial-props) from a page, it will be marked as dynamic.
</PagesOnly>
## Version History
| Version | Changes |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `v16.0.0` | `appIsrStatus`, `buildActivity`, and `buildActivityPosition` options have been removed. |
| `v15.2.0` | Improved on-screen indicator with new `position` option. `appIsrStatus`, `buildActivity`, and `buildActivityPosition` options have been deprecated. |
| `v15.0.0` | Static on-screen indicator added with `appIsrStatus` option. |