Switch the pre-rendering method in a JSS Next.js app

Current version: 21.7

You can choose the initial pre-rendering form when creating the JSS Next.js app with the optional prerender parameter. If you omit the parameter, the application is optimized for static site generation (SSG) by default. For example:

RequestResponse
npx create-sitecore-jss --templates nextjs --appName my-nextjs-app --prerender {SSG|SSR}

The JSS Next.js application comes with an optional catch-all route defined in <src>/pages/[[..path]].tsx. The route can be optimized for either static site generation (SSG) or server-side rendering (SSR).

The route file is created, based on the value you provide for the --prerender parameter with the functionality for fetching data for SSR or fetching data for SSG.

After creating the application, you may wish to switch the pre-rendering form or use both types of data fetching for hybrid rendering.

To switch the JSS Next.js application from SSG to SSR:

  1. In the file <src>/pages/[[..path]].tsx, remove the function getStaticPaths.

  2. In the file <src>/pages/[[..path]].tsx, rename the function getStaticProps to getServerSideProps and remove the revalidate property from the object returned by the function.

  3. Optionally, delete the folder /<src>/lib/sitemap-fetcher.

To switch the JSS Next.js application from SSR to SSG:

  1. In the file <src>/pages/[[..path]].tsx, define the getStaticPaths function, as follows:

    RequestResponse
    export const getStaticPaths: GetStaticPaths = async (context) => {
      if (process.env.NODE_ENV !== 'development') {
        // Note: Next.js runs export in production mode
        const paths = await sitemapFetcher.fetch(context);
        return {
          paths,
          fallback: process.env.EXPORT_MODE ? false : 'blocking',
        };
      }
      return {
        paths: [],
        fallback: 'blocking',
      }
    ;};
  2. In the file <src>/pages/[[..path]].tsx, rename the function getServerSideProps to getStaticProps and add the revalidate property to the object returned by the function. For example:

    RequestResponse
    export const getStaticProps: GetStaticProps = async (context) => {
     const props = await sitecorePagePropsFactory.create(context);
      return {
        props,
        revalidate: 5, // In seconds
        notFound: props.notFound, // Returns custom 404 page with a status code of 404 when true
      };
    };
  3. In <src>/lib, copy the folder sitemap-fetcher from the app template repository.

Do you have some feedback for us?

If you have suggestions for improving this article,