As of 28th May 2016, only the most current version of Aarcade themes will receive personal support and updates – read more…

  Back to Top

How do I use the Custom Options for my Big Cartel theme?

Filed in Getting Started & Troubleshooting

Custom Options are the the system of settings, accessed via your theme pages, that allow you to control the many additional features of your Aarcade theme, e.g. options for social network and sharing, image sizing, navigation/menus and much more.

Primary Custom Options

To view your primary Custom Options, click the Customize design link at the top right of your Big Cartel admin area:

Customize Design in Big Cartel

Click the advanced icon (advanced) and click the theme file title Layout:

Layout Theme File - Big Cartel

Clicking the full screen icon (openfullscreen) will allow you to view and work with your custom options more easily:

Full Screen Edit Mode Big Cartel

On the following page, view the first section of the text box content; your Custom Options section will begin with the text:

{{ ## START CUSTOM OPTIONS ## }}

and end with the text:

{{ #### END CUSTOM OPTIONS #### }}

Between this start and end marker, your custom options will be divided into sections.

Big Cartel Custom Options

Primary Custom Options located at the top of the Layout page coding

Other Custom Options

Your Custom Options are not just located in your Layout page, but are spread across multiple pages. From the Advanced (advanced) customisation section of your shop admin, click each page title to view the first section of code. If the page includes Custom Options, they will be enclosed by the same start and end markers described above.

Most themes will include custom options on each page and it is recommended that you review and set all Custom Options when first setting up your theme.

Custom Option Notes

Each Custom Option section begins with a link to the Custom Option Notes:

{{ ## START CUSTOM OPTIONS ## }}


{{ REFER TO NOTES AT: http://support.aarcadethemes.com/custom-option-notes/ }}

These notes provide detailed explanations, instructions and examples for helping you set your Custom Options correctly. Each Custom Option setting will be labelled with the correct note number for you to reference at the Custom Option Notes:

{{ *See Note 2 }}
{% assign favicon_url = '' %}
 

Working With Assign-Type Custom Options

Most Custom Options begin with the code {% assign and are generally explained by the name of the custom option itself and, where required, by additional notes (see previous section).

Assign-Type Custom Option values are entered inside the single quotes at the end of the {% assign code:

{% assign this_is_a_custom_option = 'your-value-goes-here' %}

To leave a Custom Option blank, you must still leave the single quotes:

{% assign this_is_a_custom_option = '' %}

IMPORTANT: Always click the Save link at the top of the Advanced section of your admin after editing your CUSTOM OPTIONS. If you entered full screen mode to edit your custom options, you will need to first exit this mode by clicking the closefullscreen button and then you can click the Save link. Never enter text anywhere other than inside the option single quotes.

In some cases you may need to include an apostrophe or single quote in your value. In this case you must surround your value with double quotes to define the start and end of your value without error. For example:

{% assign this_is_a_custom_option = "World's Greatest" %}

Working With Capture-Type Custom Options

Capture-type custom options work in the same way as assign-type custom options, however instead of entering your custom option value between single quotes you enter it on new lines between a capture and endcapture tag:

{% capture additional_footer_text %}
your-value-goes-here
{% endcapture %}

Capture-type custom options are generally used to allow text, line breaks and HTML in your custom option value:

{% capture footer_text %}
<span style="color: red;">This text is red!</span>

This will be a new paragraph.
{% endcapture %}

IMPORTANT: Never enter text on the same line as the capture or endcapture tag or anywhere other than between these two tags.

 

Example

You may have the following Custom Option in the {{ NETWORK AND SHARING OPTIONS }} section of your Custom Options:

{{ *See Note 13 }}
{% assign your_facebook_page_url = '' %}

From the name of the Custom Option, i.e. “your_facebook_page_url”, it is clear the intention is to enter your Facebook URL in to this option. By scrolling to the top of the Custom Options section, you will find where to locate your Custom Option Notes:

{{ ## START CUSTOM OPTIONS ## }}


{{ REFER TO NOTES AT: http://support.aarcadethemes.com/custom-option-notes/ }}

By visiting the Custom Option Notes you can read additional instructions for this option in NOTE 13.

NOTE 13
These options control the display of your social network links. To display a link, enter the complete URL (including the http://) for the relevant social network service…

Based upon these notes, you decide you want to include your Facebook with your social links, so you edit the option as follows:

{{ *See NOTE 13 }}
{% assign your_facebook_page_url = 'http://facebook.com/aarcade' %}

Then click the Save link at the top of the Advanced section of your admin. If you entered full screen mode to edit your custom options, you will need to first exit this mode by clicking the closefullscreen button and then you can click the Save link.

Related articles...