> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmhouse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Building templates

> Find, edit, preview, and publish Customer Portal templates.

Customer Portal templates control the pages and flows customers see in the new portal. You can edit templates from Firmhouse, save unpublished versions, preview all latest saved versions together, and publish a version when it is ready for customers.

Firmhouse provides default templates for every project. You only need to create saved versions for templates you want to customize.

## Open the template editor

You can find Customer Portal templates in your Firmhouse project.

1. Open **Customer Portal** in the main sidebar.
2. Click **Templates**.
3. Select the template you want to edit.

The template editor shows the Liquid template body and the saved versions for that template.

## Save a new version

When you save a template, Firmhouse creates a new saved version. Saved versions are not visible to customers until you publish one.

1. Open a template in **Customer Portal > Templates**.
2. Make your changes in the editor.
3. Add or update the version title when you want to make the version easier to recognize later.
4. Click **Save**.

Use the version selector to switch between saved versions of the same template.

## Preview template changes

Use **Preview latest package** when you want to test the latest saved version of every Customer Portal template together before publishing.

1. Open **Customer Portal > Templates**.
2. Open any template in the editor.
3. Click **Preview latest package**.
4. Continue from the preview confirmation page to the Customer Portal.
5. Open a customer login link in the same browser when you want to test a real subscription.

The package preview is enabled in your browser for one hour. During that hour, Customer Portal pages use the latest saved version of every template where one exists. Templates without a saved version continue using the live published version.

A preview banner appears at the bottom of Customer Portal pages when the previewed package differs from the live portal. Use **View live portal** from that banner, or disable the preview from the preview confirmation page, to return your browser to the live portal.

## Publish a version

Publishing a version makes it live for customers.

1. Open the template in **Customer Portal > Templates**.
2. Select the saved version you want customers to see.
3. Click **Publish**.

The templates overview shows which version is currently published. Publishing one template does not automatically publish other templates, so preview related changes together before publishing when your work spans multiple pages.

## Start from the default template

When you want to use the Firmhouse default as a starting point, click **Start from default**. Firmhouse creates a new unpublished version based on the current default template.

When you want customers to immediately see the Firmhouse default template again, click **Reset**. Resetting does not delete saved versions. You can still return to an earlier saved version and publish it later.

## Template reference

Use the template reference pages when you need to see which Liquid tags and parameters are available for each template.

* [Common Liquid tags](/customer-portal-v2/components/common)
* [Dashboard template Liquid tags](/customer-portal-v2/components/dashboard-template)
* [Catalog template Liquid tags](/customer-portal-v2/components/catalog-template)
* [Subscription profile template Liquid tags](/customer-portal-v2/components/subscription-profile-template)
* [Other template Liquid tags](/customer-portal-v2/components/other-template)