Displaying content in Next.js

Query your content and render it in a Next.js app.

1Install a new Next.js application

If you have an existing application, skip this first step and adapt the rest of the lesson to install Sanity dependencies to fetch and render content.

Run the following in a new tab or window in your Terminal (keep the studio running) to create a new Next.js application with Tailwind CSS and TypeScript.

You should now have your studio and Next.js application in two separate, adjacent folders:

# outside your studio directory
npx create-next-app@latest nextjs-hello-world --tailwind --ts --app --src-dir --eslint --import-alias "@/*" --turbopack
cd nextjs-hello-world
├─ /nextjs-hello-world
└─ /studio-hello-world

2Install Sanity dependencies

Run the following inside the nextjs-hello-world directory to install:

  • next-sanity a collection of utilities for integrating Next.js with Sanity
  • @sanity/image-url helper functions to take image data from Sanity and create a URL
# in nextjs-hello-world
npm install --legacy-peer-deps next-sanity @sanity/image-url @tailwindcss/typography

3Start the development server

Run the following command and open http://localhost:3000 in your browser.

# in nextjs-hello-world
npm run dev

4Configure the Sanity client

To fetch content from Sanity, you’ll first need to configure a Sanity Client.

Create a directory nextjs-hello-world/src/sanity and within it create a client.ts file, with the following code:

import { createClient } from "next-sanity";

export const client = createClient({
  projectId: "",
  dataset: "production",
  apiVersion: "2026-05-15",
  useCdn: false,
});

5Display content on the homepage

Next.js uses server components for loading data at specific routes. The current home page can be found at src/app/page.tsx.

Update it to render a list of posts fetched from your Sanity dataset using the following code:

import Link from "next/link";
import { type SanityDocument } from "next-sanity";

import { client } from "@/sanity/client";

const POSTS_QUERY = `*[
  _type == "post"
  && defined(slug.current)
]|order(publishedAt desc)[0...12]{_id, title, slug, publishedAt}`;

const options = { next: { revalidate: 30 } };

export default async function IndexPage() {
  const posts = await client.fetch<SanityDocument[]>(POSTS_QUERY, {}, options);

  return (
    <main className="container mx-auto min-h-screen max-w-3xl p-8">
      <h1 className="text-4xl font-bold mb-8">Posts</h1>
      <ul className="flex flex-col gap-y-4">
        {posts.map((post) => (
          <li className="hover:underline" key={post._id}>
            <Link href={`/${post.slug.current}`}>
              <h2 className="text-xl font-semibold">{post.title}</h2>
              <p>{new Date(post.publishedAt).toLocaleDateString()}</p>
            </Link>
          </li>
        ))}
      </ul>
    </main>
  );
}

6Display individual posts

Create a new route for individual post pages.

The dynamic value of a slug when visiting /[slug] in the URL is used as a parameter in the GROQ query used by Sanity Client.

Notice that we’re using Tailwind CSS Typography’s prose class to style the post’s body content. We installed @tailwindcss/typography in the dependencies step. Enable it by adding @plugin "@tailwindcss/typography"; to src/app/globals.css below the existing @import "tailwindcss"; line.

import { PortableText, type SanityDocument } from "next-sanity";
import { createImageUrlBuilder, type SanityImageSource } from "@sanity/image-url";
import { client } from "@/sanity/client";
import Link from "next/link";

const POST_QUERY = `*[_type == "post" && slug.current == $slug][0]`;

const { projectId, dataset } = client.config();
const urlFor = (source: SanityImageSource) =>
  projectId && dataset
    ? createImageUrlBuilder({ projectId, dataset }).image(source)
    : null;

const options = { next: { revalidate: 30 } };

export default async function PostPage({
  params,
}: {
  params: Promise<{ slug: string }>;
}) {
  const post = await client.fetch<SanityDocument>(POST_QUERY, await params, options);
  const postImageUrl = post.image
    ? urlFor(post.image)?.width(550).height(310).url()
    : null;

  return (
    <main className="container mx-auto min-h-screen max-w-3xl p-8 flex flex-col gap-4">
      <Link href="/" className="hover:underline">
        ← Back to posts
      </Link>
      {postImageUrl && (
        // eslint-disable-next-line @next/next/no-img-element
        <img
          src={postImageUrl}
          alt={post.title}
          className="aspect-video rounded-xl"
          width="550"
          height="310"
        />
      )}
      <h1 className="text-4xl font-bold mb-8">{post.title}</h1>
      <div className="prose">
        <p>Published: {new Date(post.publishedAt).toLocaleDateString()}</p>
        {Array.isArray(post.body) && <PortableText value={post.body} />}
      </div>
    </main>
  );
}

Was this page helpful?

Previous

Defining a schema

Next

Deploying Studio and inviting editors

sanity.ioAll Systems Operational© Sanity 2026
Change site theme