How to Use the Block Library

On this page

1. Block Library Overview
2. Creating Top-Level Blocks
    2.1 Creating Blocks on a Theme or Event
    2.2 Creating Blocks in the Library
3. Creating Versions of Blocks
4. Assigning Locales to Versions
5. Applying Top-Level Blocks to Themes and Events
6. Understanding the Host Experience
7. Managing the Block Library
    7.1 Archiving Blocks
    7.2 Sharing Blocks

1. Block Library Overview

The recipe for a scalable, on-brand, and compliant event program lies in your Splash Library. Located in your top-level navigation, the Library is your one-stop-shop for creating and managing event assets that can be shared across your global team. 

This guide walks you through the management of blocks, or a group of styled elements used to build event pages. Blocks that are part of your library, or top-level blocks, can be extremely powerful when it comes to scale. From inside the library, you can create multiple versions of a single block so it may apply to events held in any locale. Versions can help with text translations, location-based imagery, and other locale-specific details.

The Block Library makes it easy for your team to choose event page content that’s both relevant to their location and approved by a team admin. This is scale at its finest. Let’s dive in!

Note: Your Splash Customer Success Manager can grant designated members of your team access to the Block Library.

2. Creating Top-Level Blocks

Creating Blocks on the Theme or Event Level

In Splash, a theme is a template for your event’s website. It’s the most effective way to standardize every part of your event program from the page design, to the registration experience, and beyond. 

Themes are built just like event pages are - from a set of building blocks, including navigation blocks, cover blocks, and so on, that can be customized to bring your brand to life. 

In order for a single theme to be beneficial to your team at large, it’s important to consider which blocks may need to be slightly different depending on which team is using the theme. Examples of this could include content in a navigation block that needs to be translated or images that need to be swapped. This is the prime use case for creating a top-level block.

Once you’ve crafted the perfect block on your theme or event, click the Screen_Shot_2020-08-28_at_6.40.19_PM.png icon in the Layout Tree to save the block to your top-level Library. Give the block a name; we recommend a clear and concise name like “Library Theme Cover Block,” and assign it to a category depending on its intended use on event pages.


By default your block will be saved as editable unless you check off Save as linked block which will save your block as  non-editable. Your block will also be shared with your entire organization by default, meaning that your team can access it from the “Shared” folder when adding a new block - more on this later!

Creating Blocks in the Library

Blocks can also be created independent of a theme or event inside the Block Library. From the Block Library, click New Block:


Just like saving a block at the theme/event level, you’ll first give your block a name, then assign it to a category. Finally, decide if members of your team should be able to make edits to this block once it’s been added to an event page. Note that this includes both edits to the style of the block and the content inside of the block. 

Clicking Create will open a blank workspace where you can begin to design a block from scratch. Use the green plus inside the empty block, or the controls in the Layout Tree, to add your first element.

If your team has Global Brand Manager set up, your organization’s fonts, colors, and logo will appear. If not, we’ll display Splash’s default grayscale color swatch and font set.

3. Creating Versions of Blocks

One of the most powerful parts of the Block Library is the ability to create multiple versions of a single block. Each version can be assigned a locale, described more in the next section, which allows your block to be shared with team members across the globe.

Versions must be created from inside the Block Library. To add a new version, select your block and click the Screen_Shot_2020-09-22_at_11.37.59_AM.png button located in the outermost layer of its Layout Tree. 


This will duplicate the styles and content of the "Default Version" block to help you save time. In this example, we will create a version of the cover block that is translated in Spanish.

As a best practice, we encourage you to rename this “New Version” block according to the locale it will be used in. Try a format like “Block Name - Locale” for maximum organization.


4. Assigning Locales to Versions

Once your versions are complete, now it's time to ensure that your teammates will see the correct version of the block depending on where their event is hosted.

Click the Screen_Shot_2020-09-22_at_11.46.56_AM.png icon in the Layout Tree to access Block Settings. Here is where you can make changes to the block metadata and most importantly, assign a locale to each version of the block using our glossary of locales.


In the case that an event does not have a selected language, or the language does not correspond to a locale assigned to a version, the default (first) version of the block will be displayed. You can manually select which version should be the default inside Block Settings.


5. Applying Top-Level Blocks to Themes and Events

Earlier we mentioned that top-level blocks combined with the power of a theme allow for the maximum amount of scale. If you’ve created a block on a theme and saved it to your Block Library, your theme is in great shape.

In the scenario that you’ve independently created a top-level block from the Library level, you can apply it to a theme by clicking the icon in the theme’s Layout Tree. Your block will be located in the Yours folder.


6. Understanding the Host Experience

Now, when a teammate creates an event, they will be asked to select a locale.  


Next, they will select a theme.


If that theme contains a top-level block with a version corresponding to the locale that was selected in the create flow, your teammate will automatically see the correct version of the block.


Remember that if an event has a locale that does not correspond to a locale assigned to a version, the default (first) version of the block will display. The event page’s locale can also be edited at any time from the Event Settings tab of the event page.

7. Managing Blocks in the Library

From the Blocks tab in the Library, you can access Block Settings as well as archive and share blocks. 


Archiving Blocks

Archiving blocks will ensure the block cannot be manually added to any new themes or events. However, if you're creating an event from a theme that still includes the block, you will see the block on your event page. All existing events with the block will be unaffected.

Sharing Blocks

Apart from including top-level blocks on themes that are shared with your team, you can also manually share blocks with users, group, or your entire organization.


Non-editable blocks will appear in the Shared and Linked folders, while editable blocks will only appear in the Shared folder.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.