AI Workshop: learn to build apps with AI →
Routing & SSR: Dynamic routing

Join the AI Workshop and learn to build real-world apps with AI. A hands-on, practical program to level up your skills.


We’ve seen how to create pages, that have a static route.

  • src/pages/index.astro has the / route
  • src/pages/about.astro has the /about route

Sometimes you have the need for dynamic routes.

Dynamic routes allow you to manage multiple different URLs with a single page.

Think about a blog, for example.

You have multiple blog posts, but all use the same structure.

We’ll get to writing posts in markdown soon, but let’s do a simple example now to explain dynamic routes.

A dynamic route is created by adding a file with square brackets under src/pages.

Create a file src/pages/[post].astro

post inside the square brackets is the variable that will be passed to the page and will contain the dynamic segment.

You can grab that from Astro.params in the page frontmatter.

You must however also define and export a getStaticPaths() function, that returns an array of objects which contain the values allowed for the dynamic segment:

---
import Layout from '../layouts/Layout.astro'
const { post } = Astro.params

export async function getStaticPaths() {
  return [
    { params: { post: 'test' } },
    { params: { post: 'test2' } },
    { params: { post: 'test3' } },
  ]
}
---

<Layout title='Post'>
  <h1 style="color: white">{post}</h1>
</Layout>

If you hit the /test2 route, that’s still a route that’s taken care of by this file.

/test4 would not be, and would generate a 404 page not found message.

Note that Astro also allows multiple levels of dynamic segments, like /[category]/[post].

Lessons in this unit:

0: Introduction
1: ▶︎ Dynamic routing
2: SSR in Astro
3: API endpoints in Astro
4: Prerendering a component in an SSR page
5: Set cookie and redirect
6: Render different HTML based on HTTP method
7: Decide to render a partial or not dynamically in Astro
8: Fetching data from the network