These integration guides are not official documentation and the Strapi Support Team will not provide assistance with them.

What is Strapi?

Strapi is the leading open-source headless CMS offering features, like customizable APIs, role-based permissions, multilingual support, etc. It simplifies content management and integrates effortlessly with modern frontend frameworks.

Explore the Strapi documentation for more details.

What is Next.js?

Next.js is a popular React framework known for its performance and ease of use. It includes features such as server-side rendering (SSR), static site generation (SSG), and other advanced features, which makes it a go-to choice for modern web development.

Visit the Next.js documentation for more.

Strapi and Next.js Integration

The out-of-the-box Strapi features allow you to get up and running in no time: 1. Single types: Create one-off pages that have a unique content structure 2. Customizable API: With Strapi, you can just hop in your code editor and edit the code to fit your API to your needs. 3. Integrations: Strapi supports integrations with Cloudinary, SendGrid, Algolia, and others. 4. Editor interface: The editor allows you to pull in dynamic blocks of content. 5. Authentication: Secure and authorize access to your API with JWT or providers. 6. RBAC: Help maximize operational efficiency, reduce dev team support work, and safeguard against unauthorized access or configuration modifications. 7. i18n: Manage content in multiple languages. Easily query the different locales through the API.

Learn more about Strapi features.

Setup Strapi 5 Headless CMS

We are going to start by setting up our Strapi 5 project with the following command:

🖐️ Note: make sure that you have created a new directory for your project.

You can find the full documentation for Strapi 5 here.

npx create-strapi-app@latest server

You will be asked to choose if you would like to use Strapi Cloud we will choose to skip for now.

 Strapi   v5.6.0 🚀 Let's create your new project

 
We can't find any auth credentials in your Strapi config.

Create a free account on Strapi Cloud and benefit from:

- ✦ Blazing-fast ✦ deployment for your projects
- ✦ Exclusive ✦ access to resources to make your project successful
- An ✦ Awesome ✦ community and full enjoyment of Strapi's ecosystem

Start your 14-day free trial now!


? Please log in or sign up. 
  Login/Sign up 
❯ Skip 

After that, you will be asked how you would like to set up your project. We will choose the following options:

? Do you want to use the default database (sqlite) ? Yes
? Start with an example structure & data? Yes <-- make sure you say yes 
? Start with Typescript? Yes
? Install dependencies with npm? Yes
? Initialize a git repository? Yes

Once everything is set up and all the dependencies are installed, you can start your Strapi server with the following command:

cd server
npm run develop

You will be greeted with the Admin Create Account screen.

Go ahead and create your first Strapi user. All of this is local so you can use whatever you want.

Once you have created your user, you will be redirected to the Strapi Dashboard screen.

Publish Article Entries

Since we created our app with the example data, you should be able to navigate to your Article collection and see the data that was created for us.

Now, let's make sure that all of the data is published. If not, you can select all items via the checkbox and then click the Publish button.

Enable API Access

Once all your articles are published, we will expose our Strapi API for the Articles Collection. This can be done in Settings -> Users & Permissions plugin -> Roles -> Public -> Article.

You should have find and findOne selected. If not, go ahead and select them.

Test API

Now, if we make a GET request to http://localhost:1337/api/articles, we should see the following data for our articles.

🖐️ Note: that article covers (images) are not returned. This is because the REST API by default does not populate any relations, media fields, components, or dynamic zones.. Learn more about REST API: Population & Field Selection.

So let's get the article covers by using the populate=* parameter: http://localhost:1337/api/articles?populate=*

Nice, now that we have our Strapi 5 server setup, we can start to setup our Next.js application.

Creat a Next.js App

It is recommended to use the create-next-app, which sets up everything automatically for you.

npx create-next-app@latest

Depending on your project setup, you will answer the following prompts:

✔ What is your project named? … nextjs-project
✔ Would you like to use TypeScript? … Yes
✔ Would you like to use ESLint? … No
✔ Would you like to use Tailwind CSS? … Yes
✔ Would you like your code inside a `src/` directory? … Yes
✔ Would you like to use App Router? (recommended) … Yes
✔ Would you like to use Turbopack for `next dev`? … Yes
✔ Would you like to customize the import alias (`@/*` by default)? … No

Ensure you select "Yes" for Tailwind CSS.

Start Your Next.js Application

Start Next.js in development mode by running the command below.

npm run dev

Here is what your new Next.js application should look like on the URL http://localhost:3000:

Use an HTTP Client For Requests

Many HTTP clients are available, but on this integration page, we'll use Axios and Fetch.

Using Axios

Install Axios by running any of the commands below:

# npm
npm i axios

# yarn
yarn add axios

Using fetch

No installation needed

Fetch Contents from Strapi

Execute a GET request on the Article collection type in order to fetch all your articles.

Be sure that you activated the find permission for the Article collection type.

🖐️ NOTE: We want to also fetch covers (images) of articles, so we have to use the populate parameter as seen below.

Using Axios

1import axios;
2
3// fetch articles along with their covers
4const response = await axios.get("http://localhost:1337/api/articles?populate=*");
5console.log(response.data.data);

Using Fetch

1const response = await fetch("http://localhost:1337/api/articles?populate=*");
2const data = await response.json();
3console.log(data.data);

Project Example

In this project example, you will fetch data from Strapi and display them in your Next.js application.

Head over to your Next.js entry file ./src/app/page.tsx to proceed.

Step 1: Specify the "use client" Directory

Inside the ./src/app/page.tsx file, add the code below:

1// Path: ./src/app/page.tsx
2
3"use client"; // This is a client-side component

The "use client" directive will tell Next.js to render a component on the client-side instead of the default server directive.

Step 2: Import React hooks and Image component

Import the React hooks useEffect and useState for side effects and state management respectively.

Also, import the Image component which provides automatic image optimization.

1"use client"; // This is a client-side component
2
3// Import React hooks and Image component
4import { useEffect, useState } from "react";
5import Image from "next/image";

Step 3: Allow Images from Localhost in Next.js

Since you are working on a development environment localhost, you have to configure Next.js to allow images.

Navigate to ./next.config.ts and add the following code:

1// Path: ./next.config.ts
2
3import type { NextConfig } from "next";
4
5const nextConfig: NextConfig = {
6  /* config options here */
7
8  // Allow images from localhost
9  images: {
10    domains: ["localhost"],
11  },
12};
13
14export default nextConfig;

Step 4: Create Data Type and Constant

Create an interface called Article which represents the data structure of the articles we will fetch from Strapi. Also, create a Strapi URL constant.

1export interface Article {
2  id: string;
3  title: string;
4  content: string;
5  cover: any;
6  publishedAt: Date;
7}
8
9// Define Strapi URL
10const STRAPI_URL = "http://localhost:1337";

Step 5: Define articles State Variable

Create a state variable articles to hold articles data fetched from Strapi.

1// Define articles state
2const [articles, setArticles] = useState<Article[]>([]);

Step 6: Create Function to Fetch Articles

Create an asynchronous function that fetches the articles from the Strapi API. The data fetched is passed to setArticles to update the articles state.

1const getArticles = async () => {
2  const response = await fetch(`${STRAPI_URL}/api/articles?populate=*`);
3  const data = await response.json();
4  setArticles(data.data);
5};

Step 7: Create a Function to Format Dates

Create a helper function to format the publishedAt date of the article into a human-readable format (MM/DD/YYYY).

1const formatDate = (date: Date) => {
2  const options: Intl.DateTimeFormatOptions = {
3    year: "numeric",
4    month: "2-digit",
5    day: "2-digit",
6  };
7  return new Date(date).toLocaleDateString("en-US", options);
8};

Step 8: Fetching Articles on Component Mount

Use the useEffect to run the getArticles function when the component mounts.

1useEffect(() => {
2  getArticles();
3}, []);

Step 9: Render and Display Articles

1return (
2  <div className="p-6">
3    <h1 className="text-4xl font-bold mb-8">Next.js and Strapi Integration</h1>
4    <div>
5      <h2 className="text-2xl font-semibold mb-6">Articles</h2>
6      <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6">
7        {articles.map((article) => (
8          <article
9            key={article.id}
10            className="bg-white shadow-md rounded-lg overflow-hidden"
11          >
12            <Image
13              className="w-full h-48 object-cover"
14              src={STRAPI_URL + article.cover.url}
15              alt={article.title}
16              width={180}
17              height={38}
18              priority
19            />
20            <div className="p-4">
21              <h3 className="text-lg font-bold mb-2">{article.title}</h3>
22              <p className="text-gray-600 mb-4">{article.content}</p>
23              <p className="text-sm text-gray-500">
24                Published: {formatDate(article.publishedAt)}
25              </p>
26            </div>
27          </article>
28        ))}
29      </div>
30    </div>
31  </div>
32);

Now, this is what your Next.js project should look like:

Awesome, congratulations!

Github Project Repo

You can find the complete code for this project in the following Github repo.

Strapi Open Office Hours

If you have any questions about Strapi 5 or just would like to stop by and say hi, you can join us at Strapi's Discord Open Office Hours Monday through Friday at 12:30 pm - 1:30 pm CST: Strapi Discord Open Office Hours

For more details, visit the Strapi documentation and Next.js documentation.

See Strapi in action with an interactive demo

Explore Strapi in an instant, hands-on demo set up just for you.

• Access Live Demo!

FAQ