Rendering collection content in Astro

Introduction

Rendering collection content helps you show lists of data from your database on your website in a clear and organized way.

Displaying a list of blog posts on your homepage.

Showing all products in an online store.

Listing user comments under an article.

Presenting events happening this month.

Showing a gallery of images stored in your database.

Syntax

Astro

import { getCollection } from 'astro:content';
const collection = await getCollection('collectionName');

---

<ul>
  {collection.map(item => (
    <li>{item.data.title}</li>
  ))}
</ul>

Use import { getCollection } from 'astro:content'; and await getCollection('collectionName') to get all items from a collection.

Use .map() to loop through each item and render it.

Examples

This example fetches all blog posts and shows their titles in a list.

Astro

import { getCollection } from 'astro:content';
const posts = await getCollection('posts');

---

<ul>
  {posts.map(post => (
    <li>{post.data.title}</li>
  ))}
</ul>

This example fetches products and displays each product's name and price.

Astro

import { getCollection } from 'astro:content';
const products = await getCollection('products');

---

<div>
  {products.map(product => (
    <div>
      <h2>{product.data.name}</h2>
      <p>Price: ${product.data.price}</p>
    </div>
  ))}
</div>

Sample Program

This code fetches all events and shows them as a list with their date and title.

Astro

import { getCollection } from 'astro:content';
const events = await getCollection('events');

---

<section>
  <h1>Upcoming Events</h1>
  <ul>
    {events.map(event => (
      <li>{event.data.date} - {event.data.title}</li>
    ))}
  </ul>
</section>

Important Notes

Make sure your collection name matches exactly the one in your database or content folder.

Rendering large collections can slow down your page; consider pagination or limiting items.

You can customize how each item looks by changing the HTML inside the map function.

Summary

Rendering collection content means showing many items from your database on a page.

Use getCollection from 'astro:content' to get the collection data.

Loop through the collection with .map() to display each item.

Practice

1. What does Astro.fetchContent do in rendering collection content?

easy

A. It deletes items from the database.

B. It styles the collection items automatically.

C. It fetches data from a collection to display on the page.

D. It creates a new collection in the database.

Solution

1. Step 1: Understand the purpose of Astro.fetchContent

   This function is used to get data from a collection, so you can use it in your page.

2. Step 2: Identify what happens with the data

   The fetched data is then used to show each item on the page, not to style, delete, or create collections.

3. Final Answer:

   It fetches data from a collection to display on the page. -> Option C

4. Quick Check:

   Astro.fetchContent fetches data [OK]

Hint: Remember: fetch means get data, not change it [OK]

Common Mistakes:

• Thinking fetchContent styles or deletes data
• Confusing fetching with creating collections

2. Which of the following is the correct syntax to loop through a collection named posts in Astro to render each item?

easy

A. {posts.each(post => <div>{post.title}</div>)}

B. {posts.forEach(post => <div>{post.title}</div>)}

C. {posts.loop(post => <div>{post.title}</div>)}

D. {posts.map(post => <div>{post.title}</div>)}

Solution

1. Step 1: Identify the correct method to transform arrays in Astro

   Astro uses JavaScript array methods; .map() returns a new array of elements for rendering.

2. Step 2: Check other options for correctness

   forEach does not return an array, so it won't render correctly. loop and each are not valid JavaScript array methods.

3. Final Answer:

   {posts.map(post => <div>{post.title}</div>)} -> Option D

4. Quick Check:

   Use .map() to render collections [OK]

Hint: Use .map() to create elements from arrays [OK]

Common Mistakes:

• Using forEach which returns undefined
• Using non-existent methods like loop or each

3. Given the collection products with items [{name: 'Pen'}, {name: 'Book'}], what will this Astro code output?

{products.map(p => `
${p.name}
`).join('')}

medium

A. PenBook

B. [object Object][object Object]

C. products

D. SyntaxError

Solution

1. Step 1: Understand the map function output

   Each product's name is wrapped in <p> tags, creating an array of strings: ['

   Pen

   ', '

   Book

   '].

2. Step 2: Understand the join('') method

   Joining the array with empty string combines the strings into one: '

   Pen

   Book

   '.

3. Final Answer:

   <p>Pen</p><p>Book</p> -> Option A

4. Quick Check:

   map + join creates combined HTML string [OK]

Hint: map returns array; join('') combines to string [OK]

Common Mistakes:

• Expecting array output instead of joined string
• Confusing object output with string output

4. You wrote this code to render a collection but get an error:

const items = Astro.fetchContent('items');
return items.map(item => <li>{item.name}</li>);

What is the likely problem?

medium

A. You used map instead of forEach.

B. Astro.fetchContent returns a Promise, but you didn't await it.

C. You forgot to import Astro.

D. You cannot use return inside Astro components.

Solution

1. Step 1: Check how Astro.fetchContent works

   This function returns a Promise, so you must await it to get the data array.

2. Step 2: Identify the error cause

   Without await, items is a Promise object, so calling map on it causes an error.

3. Final Answer:

   Astro.fetchContent returns a Promise, but you didn't await it. -> Option B

4. Quick Check:

   Always await async fetchContent calls [OK]

Hint: Always await fetchContent to get data array [OK]

Common Mistakes:

• Not awaiting async fetchContent
• Confusing map and forEach usage
• Assuming fetchContent returns data directly

5. You want to render a list of blog posts but only show posts with a published flag set to true. Which Astro code correctly fetches and renders only published posts from the blogs collection?

hard

A. const posts = await Astro.fetchContent('blogs');
return posts.filter(post => post.published).map(post => <article>{post.title}</article>);

B. const posts = Astro.fetchContent('blogs').filter(post => post.published);
return posts.map(post => <article>{post.title}</article>);

C. const posts = await Astro.fetchContent('blogs');
return posts.map(post => {
if(post.published) return <article>{post.title}</article>;
});

D. const posts = await Astro.fetchContent('blogs');
return posts.map(post => post.published ? <article>{post.title}</article> : null);

Solution

1. Step 1: Fetch the collection data asynchronously

   Use await with Astro.fetchContent to get the posts array.

2. Step 2: Filter posts with published flag true before rendering

   Use filter(post => post.published) to keep only published posts, then map to render.

3. Final Answer:

   Fetch with await, filter published, then map to render. -> Option A

4. Quick Check:

   Filter before map for conditional rendering [OK]

Hint: Filter first, then map to render filtered items [OK]

Common Mistakes:

• Not awaiting fetchContent before filtering
• Filtering on Promise instead of data array
• Returning undefined for unfiltered items