Enabling SSR in Astro

Introduction

Enabling SSR (Server-Side Rendering) in Astro lets your website generate pages on the server before sending them to the browser. This makes pages load faster and helps search engines understand your content better.

You want your website pages to load quickly with content ready to see immediately.

You need better SEO so search engines can read your page content easily.

Your site has dynamic data that changes often and should be fresh on each visit.

You want to reduce the work the browser does by doing rendering on the server.

You want to support users with slower devices or connections by sending ready HTML.

Syntax

Astro

export const ssr = true;

Place this line at the top of your Astro component file to enable SSR for that page or component.

By default, Astro pages are static. Adding this line switches rendering to server-side.

Examples

This example enables SSR for a simple Astro page that renders a heading on the server.

Astro

---
export const ssr = true;
---
<html>
  <body>
    <h1>Hello from SSR!</h1>
  </body>
</html>

This page shows the current server time, which updates on every request because SSR is enabled.

Astro

---
export const ssr = true;
const time = new Date().toLocaleTimeString();
---
<html>
  <body>
    <p>Current server time: {time}</p>
  </body>
</html>

Sample Program

This Astro page enables SSR and renders a greeting message on the server. When you visit this page, the HTML is fully generated on the server and sent to your browser ready to display.

Astro

---
export const ssr = true;
const greeting = 'Welcome to SSR with Astro!';
---
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>SSR Example</title>
  </head>
  <body>
    <h1>{greeting}</h1>
  </body>
</html>

Important Notes

Remember to restart your Astro dev server after changing SSR settings to see the effect.

SSR can increase server load, so use it when you need dynamic content or SEO benefits.

Combine SSR with client-side hydration if you want interactive components after the page loads.

Summary

Adding export const ssr = true; in an Astro file enables server-side rendering.

SSR helps pages load faster and improves SEO by sending ready HTML from the server.

Use SSR when your page needs fresh data or better search engine visibility.

Practice

1. What does adding export const ssr = true; in an Astro component do?

easy

A. Turns off all rendering for the component

B. Disables client-side JavaScript for the component

C. Makes the component load only on the client

D. Enables server-side rendering for that component

Solution

1. Step 1: Understand the purpose of ssr in Astro

   Setting export const ssr = true; tells Astro to render the component on the server before sending it to the browser.

2. Step 2: Compare with other options

   The other options describe disabling or client-only behavior, which is not what ssr = true does.

3. Final Answer:

   Enables server-side rendering for that component -> Option D

4. Quick Check:

   SSR enabled = export const ssr = true [OK]

Hint: Remember: ssr=true means server renders HTML first [OK]

Common Mistakes:

• Thinking ssr disables JavaScript
• Confusing SSR with client-only rendering
• Assuming ssr=true stops rendering

2. Which of the following is the correct way to enable SSR in an Astro component?

easy

A. export const ssr = true;

B. export const ssr = false;

C. const ssr = true;

D. enableSSR(true);

Solution

1. Step 1: Identify correct syntax for SSR in Astro

   The correct syntax is to export a constant named ssr with value true to enable SSR.

2. Step 2: Check each option

   export const ssr = false; disables SSR. const ssr = true; misses export. enableSSR(true); is not valid Astro syntax.

3. Final Answer:

   export const ssr = true; -> Option A

4. Quick Check:

   Correct SSR syntax = export const ssr = true [OK]

Hint: Look for 'export const ssr = true;' exactly [OK]

Common Mistakes:

• Forgetting to export the ssr constant
• Using a function call instead of export
• Setting ssr to false by mistake

3. Given this Astro component code:

---
export const ssr = true;
const time = new Date().toISOString();
---
Current time: {time}

What will the user see when they load this page?

medium

A. The current time when the page was requested (fresh time)

B. The current time when the page was built (static time)

C. An error because ssr cannot be true

D. No time displayed because SSR disables variables

Solution

1. Step 1: Understand SSR effect on data

   With ssr = true, the page is rendered on the server at request time, so new Date() runs fresh each request.

2. Step 2: Compare options

   The current time when the page was built (static time) is static build time (no SSR). An error because ssr cannot be true is false; SSR=true is valid. No time displayed because SSR disables variables is incorrect; SSR does not disable variables.

3. Final Answer:

   The current time when the page was requested (fresh time) -> Option A

4. Quick Check:

   SSR renders fresh data on each request [OK]

Hint: SSR runs code fresh on server per request [OK]

Common Mistakes:

• Thinking SSR uses build time data
• Assuming SSR disables JavaScript variables
• Confusing SSR with static site generation

4. You wrote this Astro component:

---
ssr = true;
---
Hello world

Why does this cause an error?

medium

A. Because ssr must be a function, not a variable

B. Because ssr cannot be set to true

C. Because ssr must be exported with export const

D. Because ssr must be set inside the HTML, not script

Solution

1. Step 1: Check correct SSR syntax

   SSR must be enabled by exporting a constant: export const ssr = true;. Just assigning ssr = true; is invalid.

2. Step 2: Analyze error cause

   Without export const, Astro does not recognize the SSR flag, causing an error.

3. Final Answer:

   Because ssr must be exported with export const -> Option C

4. Quick Check:

   SSR requires export const ssr = true [OK]

Hint: Always use 'export const ssr = true;' to enable SSR [OK]

Common Mistakes:

• Forgetting to export ssr
• Setting ssr without const
• Trying to set ssr inside HTML

5. You want to create an Astro page that shows a user's profile with fresh data on every request. Which approach correctly enables SSR and fetches fresh data?

---
// Fill in the missing code
---
User Profile
Name: {user.name}
Age: {user.age}

hard

A. const ssr = true;
const user = fetchUserFromAPI();

B. export const ssr = true;
const user = await fetchUserFromAPI();

C. export const ssr = false;
const user = await fetchUserFromAPI();

D. export const ssr = true;
const user = fetchUserFromAPI();

Solution

1. Step 1: Enable SSR correctly

   Use export const ssr = true; to enable server-side rendering so data is fresh on each request.

2. Step 2: Fetch data asynchronously

   Use await to fetch user data asynchronously before rendering the page.

3. Step 3: Analyze options

   export const ssr = false; const user = await fetchUserFromAPI(); disables SSR, so data won't be fresh. const ssr = true; const user = fetchUserFromAPI(); misses export and await. export const ssr = true; const user = fetchUserFromAPI(); misses await, so user is a Promise, causing error.

4. Final Answer:

   export const ssr = true; const user = await fetchUserFromAPI(); -> Option B

5. Quick Check:

   SSR + await fetch = fresh data per request [OK]

Hint: Use 'export const ssr = true;' and await data fetch [OK]

Common Mistakes:

• Not exporting ssr constant
• Forgetting to await async data fetch
• Disabling SSR by setting ssr to false