How to Create Rendering Variants in Sitecore XM Cloud with Next.js

Learn how to create variants for your Sitecore renderings and apply them in Next.js

April 16, 2024

By John Flores

Recently we had encountered challenges on handling difference designs for the same set of templates. We could have ended up bloating the list of JSON Renderings we had with every minute design differences the client wanted us to do.

Luckily, we found the Sitecore XM Cloud’s ability to add rendering variants for our JSON Renderings. You can expose different content content for each variant, only displaying the necessary information needed for the component while maintaining the same source of data.

Sitecore Rendering Variants

Rendering variants can be used to solve multiple problems and optimize solutions within your project. Here are a couple of scenarios it could be useful to use rendering variants:

  • Display different layout or designs without the need to create different templates or renderings. It’s way easier to add a new variant rather than introducing a totally new rendering into your system. New renderings mean you will have to setup the Allowed Controls and also add it into your toolbar for it to be used.
  • You can utilize rendering variants for A/B tests. Without the need to overhaul any existing designs, you can add a new variant in order to test tweaks on the component with Sitecore’s analytics you can make decisions on whether the new variants serve a better purpose or not.
  • Rendering variants can handle further expansion of existing components. Whether you want to introduce new fields or even a placeholder for a specific variant.

For every Sitecore Rendering you make, you have the option of customizing different rendering variants with it. This does not need any different process of creating component renderings, instead you can create rendering variants from your existing components.

Setting Up Your Rendering Variant

Let’s start off by creating the template and JSON rendering for the component, and let’s call it Card. I’ll skip specifying where these are meant to be created and go directly to where to add the rendering variant. This should be located inside the Content Section of your Content Editor and inside your Headless Site look for the presentation. You should be able to find an item called Headless Variants.

Screenshot of Sitecore's Content Editor showing 'Headless Variants' and 'Card' items.

Next, you can insert a Variants item inside. Name your item the same name you had for your rendering. In our case, we named our JSON Rendering as Card, then we name the variant as the same.

Dropdown menu for creating new 'Variants' inside the 'Headless Variants' section of Sitecore.

It should look like the screenshot below. Next, we can create the different variants we want inside of it. The first variant you should add is the Default variant, it’s the expected variant you should have. Without it the moment you change variants, you cannot revert it back to the initial one.

Three card design variants named 'WithAccent', 'Default', and 'NoImage'.

Here we created 3 new variants, each one serves a different purpose.

Tree structure of Sitecore's headless site with 'Headless Variants' highlighted.

Below you can see a proposed idea for each variant. WithAccent may be an idea from the stakeholders to help make the Card pop out. NoImage are for situations you are using the same datasource but need to not display the image.

Detailed view of 'Card' component variants with different styles in Sitecore.

When you add the Sitecore rendering on the Presentation of a Page, under the Styling Section you will find a Variant field which is a dropdown that will hold all the different variants you have defined.

Sitecore interface showing a dropdown for selecting 'Card' component variants like 'Vertical'.

Similarly, on the Experience Editor, when you select the component, you will see a dropdown on the popup which you can then select the new variants.

Dropdown within Sitecore's editing interface to assign different 'Card Row' variants.

Converting Your Next.js Components to Allow Rendering Variants

We simply do not need to do anything with your existing file structure. You’ll only be looking at the Card.tsx file. Let’s look at a classic way of how your file may look like.

import {
  Field,
  ImageField,
  RichTextField,
  withDatasourceCheck,
} from '@sitecore-jss/sitecore-jss-nextjs';
import React from 'react';
import { ComponentProps } from 'lib/component-props';

type Fields = {
  image?: ImageField;
  heading?: Field<string>;
  body?: RichTextField;
  publishDate?: Field<string>;
};

type CardProps = ComponentProps & {
  fields: Fields;
};

const Card = () => {
  return <div>Your card content here</div>;
};

export default withDatasourceCheck()<CardProps>(Card);

We have your component and added in a withDatasourceCheck along with making the component it’s default export. Let’s convert this to one that allows rendering variants. Here we convert the existing component as your Default and instead we handle each variant as it’s own export. Make sure the name is exactly the same with what’s on the Content Editor.

import {
  Field,
  ImageField,
  RichTextField,
  withDatasourceCheck,
} from '@sitecore-jss/sitecore-jss-nextjs';
import React from 'react';
import { ComponentProps } from 'lib/component-props';

type Fields = {
  image?: ImageField;
  heading?: Field<string>;
  body?: RichTextField;
  publishDate?: Field<string>;
};

type CardProps = ComponentProps & {
  fields: Fields;
};

export const Default = (props: CardProps) => {
  return <div>Your card content here</div>;
};

export const WithAccent = (props: CardProps) => {
  return <div>Your card content here</div>;
};

export const NoImage = (props: CardProps) => {
  return <div>Your card content here</div>;
};

The Strategic Advantage of Sitecore Rendering Variants

Rendering variants can be used to solve different problems but doesn’t limit it as the only solution you can use. Play around and get familiarized with using rendering variants and you’ll be able to strategically use it in your project.

Check out the Sitecore Documentation on Rendering Variants.



John Headshot

John Flores

Front-End Developer

John is a Senior Front-End Developer who is passionate about design and development. Outside of work, John has wide range of hobbies, from his plant collection, being a dog daddy, and a foodie.