devIndicators
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.
Setting devIndicators
to false
will hide the indicator, however Next.js will continue to surface any build or runtime errors that were encountered.
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 static rendering.
You can confirm if a route is static or dynamic 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:
There are two reasons a route might opt out of static rendering:
- The presence of Dynamic APIs which rely on runtime information.
- An uncached data request, 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
or <Suspense />
to leverage streaming.
Version History
Version | Changes |
---|---|
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. |