Creating a Custom Panel (Blueprint)

These instructions 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 approved agencies or our Community Forum. Due to our Design Policy, our Techincal Support is unable to edit code or make design changes.

Creating your panel

1. Open a text editor, such as Notepad or TextEdit.

2. Put in the code that you want your panel to contain. The video 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.

If you are creating a custom template file instead of a panel, such as category.html or product.html, the file name must have an underscore at the beginning. E.g. _category.html or _product.html.

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 › Themes, then click the Edit HTML/CSS button.

Edit HTML/CSS button

2. Select the template file you want to reference your panel from the list on the left. If you want it to be on default.html, like in the video, you can skip this step.

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 › More › Template Files.

Was this article helpful?