Creating a Custom Panel (Blueprint)

These instructions only apply to our free legacy Blueprint Themes that have not been customized. The BigCommerce Support Team may not be able to assist with issues that occur after applying them to a previously customized theme. As always, we recommend backing up your current theme customizations before making any changes.

Don't feel comfortable adjusting your design or want to work with an expert? Check out our BigCommerce Partners or our Community. In keeping with our Design Policy, our Techincal Support is unable to edit code or make design changes.

On a Blueprint theme, panels refer to sections of code that can be reused on several pages using a variable such as %%Panel.TopBanner%%. It makes it easier to move elements of a page around without having to copy and paste code. Panels can contain HTML

Creating your panel

1. Open a plain text editor installed on your computer, such as Notepad or TextEdit.

2. Put in the code that you want your panel to contain. The example contains an image banner that links to another URL. Feel free to use the code below as a template and replace the values with your own information.

<div id="YourPanelNameHere">
    <a href="YourDestinationURLGoesHere">
    <img src="YourImageURLGoesHere">

An html file with the above code filled out.

3. Save the file as FileName.html. The name can be anything, but it cannot contain spaces or special characters, and must end with a .html extension.

An html file in a folder on the computer.

Uploading your file into WebDAV

1. Connect to your store through WebDAV.

2. Open the Template folder, then the Panels subfolder.

3. Drag and drop your file from your computer into the Panels folder. You may need to re-enter your credentials.

The Template folder in CyberDuck

Referencing your panel

The panel now needs to be referenced in the template file you want to contain it. The location will vary depending on what the panel is and where you want it to appear.

1. In the BigCommerce control panel, go to Storefront Design › My Themes, then click the Edit HTML/CSS button.


2. Select the template file you want to reference your panel from the list on the left.

The list of template files on the left of the HTML Editor

3. Locate where on the template file you want to have your panel referenced. Insert the following: %%Panel.FileName%%, where FileName is what you named your html file (without the .html at the end). This is case-sensitive, so make sure that it is typed in exactly.

The template file containing the panel reference

4. Save the template file. Double-check your work by making sure your storefront is now showing your changes.

You can now edit your custom panel from the HTML Editor. Just locate it in the Panels section in the lists on the left. It will also be in the Panels folder under Design Options › More › Template Files.

Was this article helpful?