unstable_noStore()

unstable_noStore(): void

unstable_noStore declaratively opts the enclosing scope out of prerendering and marks it as not cacheable. It was the answer for data sources that do not go through fetch — an ORM query, an SDK call — where you could not simply pass cache: 'no-store'.

Status

This is a legacy API, still supported for backward compatibility. Since version 15 the recommended replacement is connection() from next/server, which expresses the same intent — wait for an actual request before rendering this — without the caching-era naming.

What trips people up

• It is per-component, which is the reason to prefer it over export const dynamic = 'force-dynamic': the rest of the route can still be prerendered. People who reach for the segment config instead lose static rendering for the whole page.
• Inside unstable_cache it does not opt out of static generation — the cache configuration wins. Calling it there to "force freshness" silently does nothing.
• It is equivalent to cache: 'no-store' on a fetch, so mixing both is redundant rather than doubly effective.

import { unstable_noStore as noStore } from 'next/cache'
import { db } from '@/lib/db'

export default async function LiveTotal() {
  noStore()

  const result = await db.orders.aggregate({ _sum: { amount: true } })

  return <p>Total: {result._sum.amount}</p>
}

import { connection } from 'next/server'
import { db } from '@/lib/db'

export default async function LiveTotal() {
  // Defer to request time
  await connection()

  const result = await db.orders.aggregate({ _sum: { amount: true } })

  return <p>Total: {result._sum.amount}</p>
}

import { Suspense } from 'react'
import LiveTotal from './live-total'

export default function DashboardPage() {
  return (
    <main>
      <h1>Dashboard</h1>
      {/* This heading and layout stay prerendered */}
      <Suspense fallback={<p>Loading total...</p>}>
        <LiveTotal />
      </Suspense>
    </main>
  )
}

import { unstable_cache, unstable_noStore as noStore } from 'next/cache'
import { db } from '@/lib/db'

export const getStats = unstable_cache(
  async () => {
    noStore() // ignored here: the cache configuration decides
    return db.stats.findFirst()
  },
  ['stats'],
  { revalidate: 60 }
)