> For the complete documentation index, see [llms.txt](https://help.pixfizz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pixfizz.com/ecommerce/pixfizz-ecommerce/shopper-managed-storefront/setup-required-custom-fields.md).

# Setup Required Custom Fields

Pixfizz CMS template (shopper24) has custom code built in that can be activated or adjusted through snippets or via custom fields on either pages, collections, designs or products.

**Updated May 2026**

It is possible to export/import the custom field schema on any object, no longer needing to manually add them individually. Below is a list that are supported by Shopper.&#x20;

When importing a custom field schema, **no data with be overridden and only the missing schema elements will be added.**

#### Cart/Order Custom Fields Export

{% file src="/files/R3JJhVKSx9N1D4QXaJmR" %}

#### Product Attribute Custom Fields Export

{% file src="/files/wQBQQaDXRa4FVJyyyNeM" %}

#### Design Custom Fields Export

{% file src="/files/VPYz6UHNJ5osDXf4TXUN" %}

#### Options/Variants Custom Fields Export

{% file src="/files/hHNS2p49J9bT6XFpxdkV" %}

#### Option/Variant Value Custom Fields Export

{% file src="/files/Bt4hO2tGnxHIChhnTBjn" %}

#### Collection Custom Fields Export

{% file src="/files/g6wNoAhtQxsUQN1eT6GH" %}

#### Address Custom Fields Export

{% file src="/files/3O90egrEOB8u0bVtIotx" %}

***

### Manual implementation of Custom Fields

{% embed url="<https://www.loom.com/share/4915872d8b454ba28ddb64c7e6ff2cc7?sid=e8f7d804-a5bf-45e5-899d-c08bb245b1d1>" %}
What are custom fields and how to create them
{% endembed %}

## **COLLECTION CUSTOM FIELDS**

**Name**: reverse

**Type**: boolean

**Description**: Reverse the order in which the designs are displayed. Last added to collection will show first.

**Liquid Reference**: `collection.custom.reverse`

***

**Name:** wildcard

**Type**: boolean

**Description**: Check to have the shop URL convert to collection.path/design.code

**Liquid Reference**: `collection.custom.wildcard`

***

**Name:** pdp\_layout

**Type**: boolean

**Description**: Displays the collection in a product detail page layout.

**Liquid Reference**: `collection.custom.pdp_layout`

***

**Name:** btn\_add\_to\_cart

**Type**: boolean

**Description**: Renders an Add to Cart button to skip the Design Tool.

**Liquid Reference**: `collection.custom.btn_add_to_cart`

***

**Name:** btn\_design\_tool

**Type**: boolean

**Description**: Renders an Advanced Design button, in addition to the Add to Cart button to offer the user the choice.

**Liquid Reference**: `collection.custom.btn_design_tool`

***

**Name:** select\_quantity

**Type**: boolean

**Description**: Renders a quantity input field.

**Liquid Reference**: `collection.custom.select_quantity`

***

**Name:** gallery\_stacked

**Type**: boolean

**Description**: Stack multiple images in the gallery instead of a carousel with thumbnails.

**Liquid Reference**: `collection.custom.gallery_stacked`

***

**Name:** production\_time

**Type**: number

**Description**: Enter the number of days required for production to render the value on the product page.

**Liquid Reference**: `collection.custom.production_time`

***

**Name:** collection\_filters

**Type**: snippet

**Description**: Enter in filter data.

**Liquid Reference**: `collection.custom.collection_filters`

## PRODUCT CUSTOM FIELDS

**Name**: btn\_add\_to\_cart

**Type**: boolean

**Description**: Skip the design tool and direct the user straight to the cart.

**Liquid Reference**: `product.custom.btn_add_to_cart`

***

**Name**: btn\_design\_tool

**Type**: boolean

**Description**: Only relevant when the Add to Cart button is also active, checking this will also render a button to the Design Tool.

**Liquid Reference**: `product.custom.btn_design_tool`

***

**Name**: select\_quantity

**Type**: boolean

**Description**: Render a quantity input field on product page.

**Liquid Reference**: `product.custom.select_quantity`

***

**Name**: select\_date

**Type**: boolean

**Description**: Render a start date dropdown selectors for month & year. Required for calendar products.

**Liquid Reference**: `product.custom.select_date`

***

**Name**: google\_category

**Type**: text

**Description**: Enter the Google Category code based on the Taxonomy list available [here](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt).

**Liquid Reference**: `product.custom.google_category`

***

**Name**: film\_processing

**Type**: boolean

**Description**: Activate checkout option for mail-in or drop-in.

**Liquid Reference**: `product.custom.film_processing`

***

**Name**: orientation

**Type**: text

**Description**: Commonly used with collection filters

**Liquid Reference**: `product.custom.orientation`

***

**Name**: size

**Type**: text

**Description**: Commonly used with collection filters

**Liquid Reference**: `product.custom.size`

***

**Name**: hide\_edit\_in\_cart

**Type**: boolean

**Description**: Check to remove ability to edit project from within the cart.

**Liquid Reference**: `product.custom.hide_edit_in_cart`

***

**Name**: display\_each\_pricing

**Type**: boolean

**Description**: Check to display the price per unit pricing on the product page.

**Liquid Reference**: `product.custom.display_each_pricing`

***

**Name**: from\_pricing

**Type**: number

**Description**: Minium price of product, usually at highest quantities.

**Liquid Reference**: `product.custom.from_pricing`

***

**Name**: to\_pricing

**Type**: number

**Description**: Maximum price of product, usually at lowest quantities.

**Liquid Reference**: `product.custom.to_pricing`

## DESIGN CUSTOM FIELDS

**Name**: url\_path

**Type**: text

**Description**: Required when using wildcard collection & product pages. Avoid using capitals, underscores & spaces as this will be visible in the url.

**Liquid Reference**: `design.custom.personal_dates`

***

**Name**: personal\_dates

**Type**: boolean

**Description**: Render the checkbox to select personal calendar dates to be added into a calendar or planner project.

**Liquid Reference**: `design.custom.personal_dates`

***

## **OPTIONS/VARIANTS CUSTOM FIELDS**

**Name**: selector

**Type**: text

**Description**: Add one of the following values to render the variant as a color radio button, checkbox, dropdown or slider. Leave blank to render as a radio button.

**Values**: color | checkbox | dropdown | slider

**Liquid Reference**: `order.custom.tracking`

***

**Name**: multi\_upload\_group

**Type**: text

**Description**:&#x20;

**Liquid Reference**: `order.custom.multi_upload_group`

***

## **ORDER CUSTOM FIELDS**

**Name**: tracking

**Type**: text

**Description**: Insert shipping tracking code to be rendered in shipped order email notification.

**Liquid Reference**: `order.custom.tracking`

***

## ADDRESS CUSTOM FIELDS

**Name**: opening\_hours

**Type**: snippet

**Description**: Add your store opening hours to be displayed in a modal during checkout.

**Liquid Reference**: `address.custom.opening_hours`

***

**Name**: location\_img

**Type**: asset

**Description**: Add a square image to add to the address selection during checkout.

**Liquid Reference**: `address.custom.location_img | asset_url`

***

**Name**: google\_maps\_link

**Type**: text

**Description**: Add the share link of your store's location from Google maps.

**Liquid Reference**: `address.custom.google_maps_link`
