Astro moving from collections to dynamic routing


Migrating Astro collections to Dynamic routing

28 Aug, 2021 · 4 min read

Since Astro is relatively new, elements are still evolving and changing for the better. We set up a recipe website in Astro using their collections. However, this is now changed to dynamic routing.

The principal is still the same, but the implementation became more straightforward and quicker.

This article will walk you through the change needed to move from Astro collections to Astro dynamic routing.

If you have read my older articles on collections in Astro, those are now modified to work with dynamic routing:

An overview of Astro dynamic routing

Astro is a static site generator, meaning once we build, we get one output. Astro can’t randomly generate a new page unless we run another build.

However, it can generate these dynamic pages on build time. We have to use [bracket].astro notation for our files when we want to use this.

These bracket files will have a getStaticPaths() export function.

You might notice this was the createCollection() method before.

Some of these files might look like this:

  • pages/blog/[slug].astro: Which will generate pages like: blog/hello-world, or blog/post-2.
  • pages/[username]/settings.astro: Gives us a page like chris/settings, or fred/settings.
  • pages/recipes/all/[].astro: Gives us the option for pagination: recipes/all, or recipes/all/2.

As you can see, this is super powerful also because it allows multiple brackets in the structure:

  • pages/recipes/[slug]/[].astro: Giving us URLs like: recipes/breakfast, or recipes/dinner/2.

Converting a collection into dynamic routes in Astro

Let’s take our recipe /all collection as an example of how we can move from a collection to dynamic routes in Astro.

Before, we had a page like this: pages/$recipes.astro.

Which had a export like so:

export async function createCollection() {
  const allRecipes = Astro.fetchContent('./recipe/*.md').sort((a, b) =>

  return {
    paginate: true,
    route: '/recipes/:page?',
    async props({paginate}) {
      return {
        recipes: paginate(allRecipes, {pageSize: 5}),

const {recipes} = Astro.props;

This would give us URLs like: recipes/1 and recipes/2.

We have to create another folder level in our pages folder to achieve the same with dynamic routes. This being the recipes folder.

Inside the new recipes folder create a file called: [].astro. We use the three dots to allow paginated URLs to work and a URL with nothing behind it. Some examples being: recipes, recipes/3, or recipes/10.

This file will look way simpler compared to the old collection:

export async function getStaticPaths({paginate}) {
  const allRecipes = Astro.fetchContent('./../recipe/*.md').sort((a, b) =>

  return paginate(allRecipes, {pageSize: 5});

const {page} = Astro.props;

Easier right!

In the old setup, we used the recipes variable as our output. In the new version, we use the page object. This will now have several properties:

  • The actual data for this page
  • page.start: Index of the first item of the page
  • page.end: Index of the last item on the page
  • page.size: Number of items on this page
  • Total number on all pages combined
  • page.currentPage: Current page, starting at 1
  • page.lastPage: Total number of pages
  • page.url.current: Current URL
  • page.url.prev: Link to the previous page
  • Link to the next page


Dynamic routing is a bit of a change in the file structure but gives us way more freedom, primarily because of the multiple slug options per route.

It’s also a pretty straightforward way of migrating from the old way of doing things to this new routing structure.

I hope you enjoyed this and will give Astro a shot.

Thank you for reading, and let’s connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Spread the knowledge with fellow developers on Twitter
Tweet this tip
Powered by Webmentions - Learn more

Read next 📖

Computed Nano Stores

6 Sep, 2022 · 2 min read

Computed Nano Stores

Astro Nano Stores maps

5 Sep, 2022 · 3 min read

Astro Nano Stores maps

Join 2099 devs and subscribe to my newsletter