> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/withastro/astro/llms.txt
> Use this file to discover all available pages before exploring further.
# Content Collections API
> API reference for Astro's Content Collections system
Astro's Content Collections API provides type-safe content management for your Markdown, MDX, and JSON files.
## Importing Functions
```typescript theme={null}
import {
defineCollection,
getCollection,
getEntry,
getEntries,
reference
} from 'astro:content';
```
## defineCollection
Define a content collection schema in your `src/content/config.ts` file.
```typescript theme={null}
defineCollection(config: CollectionConfig): CollectionConfig
```
Collection configuration object.
The type of collection. Use `'content'` for Markdown/MDX files with frontmatter, or `'data'` for JSON/YAML data files.
**Default:** `'content'`
A Zod schema to validate frontmatter or data.
```typescript theme={null}
import { defineCollection, z } from 'astro:content';
const blog = defineCollection({
type: 'content',
schema: z.object({
title: z.string(),
description: z.string(),
pubDate: z.date(),
tags: z.array(z.string()).optional(),
}),
});
```
A loader function for loading collection data. Used with the Content Layer API.
```typescript theme={null}
import { defineCollection } from 'astro:content';
import { glob } from 'astro/loaders';
const blog = defineCollection({
loader: glob({ pattern: '**/*.md', base: './src/data/blog' }),
});
```
### Example
```typescript theme={null}
// src/content/config.ts
import { defineCollection, z } from 'astro:content';
const blog = defineCollection({
type: 'content',
schema: z.object({
title: z.string(),
description: z.string(),
pubDate: z.coerce.date(),
updatedDate: z.coerce.date().optional(),
heroImage: z.string().optional(),
}),
});
const newsletter = defineCollection({
type: 'data',
schema: z.object({
title: z.string(),
date: z.date(),
}),
});
export const collections = { blog, newsletter };
```
## getCollection
Retrieve all entries from a collection, optionally filtered.
```typescript theme={null}
getCollection(
collection: string,
filter?: (entry: CollectionEntry) => boolean
): Promise
```
The name of the collection to query.
Optional filter function to select specific entries.
```typescript theme={null}
const publishedPosts = await getCollection('blog', (entry) => {
return entry.data.draft !== true;
});
```
An array of collection entries with the following properties:
Unique identifier for the entry (filename without extension).
URL-friendly slug for the entry.
The name of the collection this entry belongs to.
Parsed and validated frontmatter data matching your schema.
Raw Markdown/MDX content (content collections only).
Function to render the content (content collections only).
### Example
```typescript theme={null}
// src/pages/blog/index.astro
import { getCollection } from 'astro:content';
// Get all blog posts
const allPosts = await getCollection('blog');
// Get only published posts
const publishedPosts = await getCollection('blog', ({ data }) => {
return data.draft !== true;
});
// Sort by date
const sortedPosts = allPosts.sort(
(a, b) => b.data.pubDate.valueOf() - a.data.pubDate.valueOf()
);
```
## getEntry
Retrieve a single entry from a collection.
```typescript theme={null}
getEntry(collection: string, id: string): Promise
getEntry(entry: { collection: string; id: string }): Promise
getEntry(entry: { collection: string; slug: string }): Promise
```
The name of the collection.
The entry ID (filename without extension).
A single collection entry, or `undefined` if not found.
### Example
```typescript theme={null}
// src/pages/blog/[...slug].astro
import { getEntry } from 'astro:content';
const entry = await getEntry('blog', Astro.params.slug);
if (!entry) {
return Astro.redirect('/404');
}
const { Content } = await entry.render();
```
## getEntries
Retrieve multiple entries by reference.
```typescript theme={null}
getEntries(
entries: { collection: string; id: string }[]
): Promise
```
Array of entry references.
Array of matching collection entries.
### Example
```typescript theme={null}
import { getEntries } from 'astro:content';
const post = await getEntry('blog', 'welcome');
const relatedPosts = await getEntries(post.data.relatedPosts);
```
## reference
Create a reference to entries in another collection.
```typescript theme={null}
reference(collection: string): ZodSchema
```
The name of the collection to reference.
A Zod schema that validates references to the specified collection.
### Example
```typescript theme={null}
// src/content/config.ts
import { defineCollection, z, reference } from 'astro:content';
const blog = defineCollection({
type: 'content',
schema: z.object({
title: z.string(),
relatedPosts: z.array(reference('blog')).optional(),
author: reference('authors'),
}),
});
const authors = defineCollection({
type: 'data',
schema: z.object({
name: z.string(),
bio: z.string(),
}),
});
export const collections = { blog, authors };
```
```astro theme={null}
---
// src/pages/blog/[slug].astro
import { getEntry } from 'astro:content';
const post = await getEntry('blog', Astro.params.slug);
const author = await getEntry(post.data.author);
---
{post.data.title}
By {author.data.name}
```
## Rendering Content
Call `render()` on a content entry to get renderable content.
```typescript theme={null}
const entry = await getEntry('blog', 'my-post');
const { Content, headings, remarkPluginFrontmatter } = await entry.render();
```
An Astro component containing the rendered content.
```astro theme={null}
```
Array of headings extracted from the content.
```typescript theme={null}
type MarkdownHeading = {
depth: number;
slug: string;
text: string;
};
```
Frontmatter data modified or injected by remark/rehype plugins.
### Example
```astro theme={null}
---
import { getEntry } from 'astro:content';
const entry = await getEntry('blog', Astro.params.slug);
if (!entry) {
return Astro.redirect('/404');
}
const { Content, headings } = await entry.render();
---
{entry.data.title}
```