How To Configure SXA Page Branches In Sitecore

Configuring Sitecore SXA Page Branches

Page branches are one of those features that seem to be under utilized in Sitecore content authoring. They are immensely powerful and I for one am guilty of avoiding their use.

Let's look at a scenario where you've got a site that needs multiple layouts but all share similar fields. Say one has a single column of text, one has two columns, and a third that has a grid layout. Typically you'd say, ok, let's create one template for each layout and all inherit the base "content page" template. There's nothing wrong with that, but if you work with search or dynamically generated content, you'll have a bit more work on the backend to deal with the variants.

Let's Create A Branch Instead

The beauty with using a page branch is using that single content page template, we can create all three layouts for an author in advanced giving the impression of three different templates.

Create Content Page Template

First thing first, create a template that inherits the Page template. We do this rather than using the Page template itself as it allows us to customize the template rather than modifying the base template. It's also important to inherit Page as that's how the Page Branch rules are run.

Creating a new content page template in Sitecore SXA

It's also wise to generate a _Standard Values item for the template we created.

Create Page Branch

Next, let's locate the Page Branches folder inside /Sitecore/Conent/<Tenant>/<Site>/Presentation.

Opening a new page branch folder in Sitecore SXA

Right click on Page Branches and select Insert -> Page Branch.

Creating a new page branch in Sitecore SXA

When prompted enter the branch name. For the purposes of this example we're calling it Single Column Content Page. Next, in the Page template dropdown, select the template you created above. Then click OK.

Configuring single column page branches in Sitecore SXA

Once it's run the appropriate script, you'll see the branch and an item named $name. You've now created a page branch. Using Experience Editor we can customize the layout appropriately. Repeat as necessary for additional layout options.

Creating new branches in Sitecore SXA

Customize Page Branch Templates

Customizing each page branch can be done in a number of ways. I'm not going into depths about each here, but some examples are:

  • Changing layouts in Experience Editor
  • Pre-assigning components to the Shared Layout
  • Modifying Security or Workflow
  • Pre-filled fields, drop-downs, etc.

You get the idea. It's extremely handy when you have a bunch of different layouts, multiple content authors, and perhaps a complex design to utilize page branches reducing the chances of errors and ultimately speed up the authoring process.

Using Rules To Assign Insert Options

You've got one or more page branches, you've customized them, now let's add them to pages. Traditionally this would involve going to each template and changing the Insert Options.

This time around we're going back to the Page Branches folder and on the item under Data / Rule click Edit rule.

Configuring new page branches in Sitecore SXA

First, let's create a condition. Now for the puroses of this example, I'm keeping it simple. So I'm selecting where the current item is in the site context. As you can see by the number of options, you can create very complex rules. It's important to note though, that these rules rely on the item it's affecting to have inherited the Page template. They won't be run on any other template.

Next, we will click on the SXA - PageBranches action titled add the specified Page Branch to the insert options. Once added, click the word specified. You'll then be presented with a list of options of page branches you've created.

Selecting page branches in Sitecore SXA

Repeat adding the action as needed thus adding as many page branches as needed for each appropriate condition.

Setting rules for page branches in Sitecore SXA

Now, if we go to our Home item and right-click we can see under Insert our three page branches have been added.

Inserting new branches in Sitecore SXA under Home

It might have seemed like a large number of steps, but once you've done it a couple times, you'll see how quick and easy it is to do for the sites you create. Your authors with thank you.

👋 Hey Sitecore Enthusiasts!

Sign up to our bi-weekly newsletter for a bite-sized curation of valuable insight from the Sitecore community.

What’s in it for you?

  • Stay up-to-date with the latest Sitecore news
  • New to Sitecore? Learn tips and tricks to help you navigate this powerful tool
  • Sitecore pro? Expand your skill set and discover troubleshooting tips
  • Browse open careers and opportunities
  • Get a chance to be featured in upcoming editions
  • Learn our secret handshake
  • And more!
Sitecore Snack a newsletter by Fishtank Consulting

Meet David Austin

Development Team Lead | Sitecore Technology MVP x 3


David is a decorated Development Team Lead with Sitecore Technology MVP and Coveo MVP awards, as well as Sitecore CDP & Personalize Certified. He's worked in IT for 25 years; everything ranging from Developer to Business Analyst to Group Lead helping manage everything from Intranet and Internet sites to facility management and application support. David is a dedicated family man who loves to spend time with his girls. He's also an avid photographer and loves to explore new places.

Connect with David