A community-driven Astro content loader for Strapi. Fetch content from a Strapi API and use it in your Astro project with full Content Layer support.
v4 adds support for Astro v6 and Zod v4.
- Astro v6+
- Strapi v5+
- Node.js 22+
npm install strapi-community-astro-loader @strapi/clientimport { defineCollection, z } from "astro:content";
import { strapiLoader } from "strapi-community-astro-loader";
const articles = defineCollection({
loader: strapiLoader({
contentType: "article",
clientConfig: { baseURL: "http://localhost:1337/api" },
}),
schema: z.object({
title: z.string(),
slug: z.string(),
content: z.string().optional(),
}),
});
export const collections = { articles };const articles = defineCollection({
loader: strapiLoader({
contentType: "article",
clientConfig: {
baseURL: "http://localhost:1337/api",
auth: process.env.STRAPI_TOKEN,
},
}),
schema: z.object({
title: z.string(),
slug: z.string(),
}),
});Use the params option to control field population. This is passed directly to @strapi/client.
const articles = defineCollection({
loader: strapiLoader({
contentType: "article",
clientConfig: { baseURL: "http://localhost:1337/api" },
params: {
populate: {
featuredImage: { fields: ["url", "alternativeText"] },
author: {
populate: {
image: { fields: ["url", "alternativeText"] },
},
},
},
},
}),
schema: z.object({
title: z.string(),
slug: z.string(),
featuredImage: z.object({
url: z.string(),
alternativeText: z.string().nullable(),
}).optional(),
author: z.object({
fullName: z.string(),
image: z.object({
url: z.string(),
alternativeText: z.string().nullable(),
}).optional(),
}).optional(),
}),
});By default, the loader appends s to the contentType name. If your content type has a different plural form, specify it explicitly:
const categories = defineCollection({
loader: strapiLoader({
contentType: "category",
pluralContentType: "categories",
clientConfig: { baseURL: "http://localhost:1337/api" },
}),
});| Option | Type | Default | Description |
|---|---|---|---|
contentType |
string |
required | The Strapi content type to query |
clientConfig |
Config |
required | Config passed to @strapi/client (baseURL, auth) |
params |
object |
undefined |
Query params passed to Strapi (populate, filters, etc.) |
pluralContentType |
string |
${contentType}s |
Plural form of the content type name |
cacheDurationInMs |
number |
0 |
How long to cache a sync (in ms). 0 = always fetch |
pageSize |
number |
25 |
Number of items per page when paginating |
- Schema is no longer auto-inferred. Define your own schema using
zfromastro:contentindefineCollection. strapiUrlis replaced byclientConfig. Pass{ baseURL: "http://localhost:1337/api" }instead.syncIntervalis replaced bycacheDurationInMs.- No more bundled Zod. The loader uses Astro's built-in Zod, which is Zod v4 in Astro v6.
const articles = defineCollection({
loader: strapiLoader({ contentType: "article" }),
});const articles = defineCollection({
loader: strapiLoader({
contentType: "article",
clientConfig: { baseURL: "http://localhost:1337/api" },
}),
schema: z.object({
title: z.string(),
slug: z.string(),
}),
});MIT
For questions, contributions, and support, please open an issue on GitHub.
