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

  Back to Top

Custom Option Notes

For details on correctly entering custom option values, refer to How do I use the Custom Options for my Big Cartel theme?

ALWAYS enter valid values exactly as they are shown in these notes – values are CASE-SENSITIVE

ALWAYS test the results of your custom option settings immediately after editing them

NEVER create a custom option if you do not see it in your theme – refer to This is Missing or Doesn't Work for My Theme

Note (click for instructions) Description
2. Favicon Options Set your favicon and Apple device icon
3. Header Options Set header alignment and link URL
4. Menu Divider Options Define menu dividers
5. Special Menu Item Options Define the text and location of special menu items
7. Gift Certificate Options Display a link to PayPal's Gift Certificate purchase interface
8. Home Page Layout Options Define how the home page content is displayed
9. Special Products Menu Options Edit the location of the top selling / newest products menu
10. Global Product Display Options Define global product display options
11. Image Zoom Options Edit options for the product image zoom light box
12. Footer Text Options Edit options for the footer text
13. Social Network Links Display social network links (as icons)
14. RSS Feed Options Edit options for the shop RSS feed
15. Global Facebook Like Options Edit options for the Like button displayed throughout the shop
16. Global Google Plus Options Edit options for the Plus button displayed throughout the shop
17. Newsletter & Search Input Options Edit newsletter sign up form and search field display options
18. Love Options Define how you let others know about Arcaade / Big Cartel
19. Home Page Options Edit options for the display of products on the home page
20. Products Page Options Edit options for the display of products on the products pages
21. General Product Page Options Edit the general layout options for the product pages
22. Product Selector Options Edit options for the display / input of product options
23. Other Products Options Edit the options for the display of other products on product pages
24. Product Sharing Options Edit the options for the display of product sharing tools
26. PayPal Payment Options Edit the options for the PayPal payment interface
27. Checkout Message Options Define the content for the checkout processing page
28. Success Message Options Define the content for the payment success page
29. Contact Form Options Edit the options for the contact form
30. Contact Page Content Options Edit the options for the contact page content
31. Maintenance Message Options Edit the options for the maintenance mode message
32. Cart Page Options Edit the options for the cart page
33. Global Layout Options Define global layout options
34. Customer Product Notes Define customer note fields to be displayed at checkout

Note 2: Favicon Options Location: Layout page

Refer to How do I add a favicon to my Big Cartel shop? for more details on these options.

favicon_url

This option value must be a complete public URL (starting with http://) to a favicon image. For example:

{% assign favicon_url = 'http://www.google.com/favicon.ico' %}

apple_device_icon_url

This option value must be a complete public URL (starting with http://) to an Apple device icon png. For example:

{% assign apple_device_icon_url = 'http://www.apple.com/apple-touch-icon.png' %}

This image is also used used as the default image in Facebook share posts (when a product or content image is not available).

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 3: Header Options Location: Layout page

alternative_header_link_url

By default (when option value is blank), clicking the header image or text will take the visitor to the shop home page, e.g. http://myshop.bigcartel.com.

To define a different URL for the header link enter any relative URL (e.g. ‘/products’) or absolute URL (e.g. ‘http://google.com’) . For example:

{% assign alternative_header_link_url = 'http://www.mysite.com' %}

To Top of Page | This is Missing or Doesn't Work for My Theme

These options define the character/s to be used as a divider between each of the associated menu items. For example, setting the category menu divider to a vertical bar:

{% assign category_menu_item_divider = '|' %}

You can also use an entity number or name from the HTML Symbol Reference. For example, setting the page menu divider to a double dagger ( ‡ ):

{% assign page_menu_item_divider = '‡' %}

Leave value blank for menu items to be divided by a space only.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 5: Special Menu Item Options Location: Layout page

{% assign website_link_text = 'Back to Site' %}
{% assign website_link_location = 'pp' %}
{% assign open_website_in_new_window = 'no' %}

These options relate to the web site URL entered in the Store > Settings – Domain – Website field in your Big Cartel admin. For more details, refer to How do I add a link from my Big Cartel shop back to my web site or blog?).

shop_home_link_text

Defines the text used for your shop home page (e.g. http://myshop.bigcartel.com) link in your navigation menu. For example:

{% assign shop_home_link_text = 'Visit the Shop' %}

Leave the value blank to remove the shop home page link from your menus.

shop_home_link_location

Defines where the shop home page link will be displayed. Valid values are any of the following link location abbreviations:

Abbreviation Location
pp prepend to page menu
pa append to page menu
cp prepend to category menu
ca append to category menu
fp prepend to footer menu
fa append to footer menu

For example:

{% assign shop_home_link_location = 'pp' %}

all_products_link_text

Defines the text used for your all-products page (e.g. http://myshop.bigcartel.com/products) link in your navigation menu. Leave the value blank to remove the all-products page link from your menus.

all_products_link_location

Defines where the all-products page link will be displayed. Refer to shop_home_link_location above.

artists_link_text

Defines the text used for your artist category list in your navigation menu. Artist categories can be turned on via your Store > Settings – Options – Artists check box in your Big Cartel admin. For example, if you were using your artist categories for sorting by product brand instead of artists:

{% assign artists_link_text = 'Brand' %}

Leave the value blank to remove the artist category list from your menus.

artists_link_location

Defines where the artist category list will be displayed. Refer to shop_home_link_location above.

shop_menu_location

For themes with adjustable menu order, defines whether the shop menu (i.e. the products and categories menu) is displayed above or below the pages menu. Valid values are top or bottom.

page_before_cat_items

Defines whether page links that have been moved the the category menu – refer How do I control the page navigation in my Big Cartel shop? – are added before the category links or after. Valid values are yes or no.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 7: Gift Certificate Options Location: Layout page

These options are used to display a link to PayPal’s Gift Certificate purchase interface in your shop navigation menu.

gift_certificate_link_text

Defines the text used for your gift certificate link in your navigation menu. Leave the value blank to remove the gift certificate link from your menus.

gift_certificate_link_location

Defines where the gift certificate link will be displayed. Valid values are any of the following link location abbreviations:

Abbreviation Location
pp prepend to page menu
pa append to page menu
cp prepend to category menu
ca append to category menu
fp prepend to footer menu
fa append to footer menu

For example:

{% assign gift_certificate_link_location = 'pa' %}

gift_certificate_paypal_email_address

The PayPal e-mail address that will tie the gift certificate to your shop. It must be exactly the same PayPal email value set in your Store > Settings – Basics – PayPal email field in your Big Cartel admin. For example:

{% assign gift_certificate_paypal_email_address = 'hello@featherweight.co' %}

minimum_gift_certificate_value & maximum_gift_certificate_value

These options set the minimum and maximum allowable gift certificate value. Values must be whole numbers, i.e. no decimal places, and a multiple of 10, e.g. 10, 20, 30, 40, etc. Note that PayPal will round your settings to their nearest preset values.

For example:

{% assign minimum_gift_certificate_value = '30' %}
{% assign maximum_gift_certificate_value = '250' %}

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 8: Home Page Layout Options Location: Layout page

home_page_content_only

This option allows you to display only your content on the home page (i.e. hide all menus and header). This option is used for creating a “splash” or “enter” page – combined with the x ic home insert content method – that links to your all-products page.

Valid values are:

  • no – home page is displayed normally
  • yes – only content is displayed and vertically aligned to the middle
  • top – only content is displayed and vertically aligned to the top
  • bottom – onlycontent is displayed and vertically aligned to the bottom

For example, to display only the content on the home page and align the content to the top of the page:

{% assign home_page_content_only = 'top' %}

Additionally, a positive integer can be entered immediately after “top” or “bottom” to define a padding between the top or bottom and the content.

For example, to display the content 30px from the bottom of the page:

{% assign home_page_content_only = 'bottom30' %}

For more details on creating a splash page with the x ic home insert content method, refer to How do I create a custom home page for my Big Cartel shop?

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 9: Special Products Menu Options Location: Layout page

Note that the top selling and/or newest products menu must be turned on via your Customize design > Customize (customize) settings in your Big Cartel admin to display these product menus and for the following custom options to have any effect (refer to How do I use the basic "Customize" options for my Big Cartel theme?).

top_selling_and_newest_menu_location

Defines the location of the top selling / newest menu within the page content. Valid values are:

  • bottom – displayed at the bottom of the page
  • top – displayed at the bottom of the page

top_selling_and_newest_menu_on_all_pages

Defines whether the top selling / newest menu is displayed on all pages or only on the home page. Valid values are yes or no.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 10: Global Product Display Options Location: Layout page

hide_all_product_details

Controls the display of product details (title and price) in all product grid views (i.e. products page, category pages, etc.). Valid values are:

  • no – product details are displayed normally
  • yes – product details are hidden
  • hover – product details are hidden, but displayed in an overlay when the user’s pointer hovers over the product thumbnail

hide_price_for_sold_out_products

Defines whether product price is hidden for sold out products. Valid values are yes or no.

label_sold_not_sold_out

Defines whether sold out products are labelled Sold Out or simply Sold. Valid values are yes or no.

hide_price_for_coming_soon_products

Defines whether product price is hidden for coming soon products. Valid values are yes or no.

show_price_range_for_variable_priced_products

Defines whether product price range is displayed for products with variable priced options. Valid values are:

  • no – default price is displayed
  • yes – price range is displayed, e.g. $10.00 – $35.50
  • from – minimum price is displayed with “from” prefix, e.g. from $10.00

For example:

{% assign show_price_range_for_variable_priced_products = 'from' %}

collapse_thumbnail_heights

Although we do not recommend using different sized product images – see Big Cartel theme product image preparation and size – sometimes it is unavoidable. This option only has an affect if you have used different sized product images in your shop.

Aarcade themes will automatically adjust the height of each row in product thumbnail grids to the minimum possible, while still fitting to the largest image in that row. Product titles and pricing are then displayed in line. This will cause varying white space between the product titles and the bottom of the thumbnail images when image heights vary in that row.

This option allows you to collapse that white space, so that titles are directly under the thumbnails instead of all in line. Valid values are yes or no.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 11: Image Zoom Options Location: Layout page

image_zoom_style

Defines the style for the pop-up light box viewer used to zoom in on product image detail and other appropriately formatted links. Valid values are:

  • 1 – light background
  • 2 – dark background
  • 3 – 3D buttons, white border & no background
  • 4 – no border, white out background
  • 5 – black round buttons, black border & no background
  • 6 – white round buttons, no border & black out background

To Top of Page | This is Missing or Doesn't Work for My Theme

footer_text

This option content will be displayed in the footer and can include HTML. The default content includes:

  1. © – this is the HTML entity code for the copyright symbol
  2. [[year]] – this is the Aarcade shortcode for displaying the current year
  3. {{ store.name }} – this is the Big Cartel API variable for displaying your store name
{% capture footer_text %}
© [[year]] {{ store.name }}. All Rights Reserved.
{% endcapture %}

This option can be useful if you have a company name that is different to your store name and/or you have additional relevant text.

{% capture footer_text %}
© 2009 to [[year]] MyCompany LLC. All Rights Reserved.
<b>A Little Cog Venture</b>
{% endcapture %}

To Top of Page | This is Missing or Doesn't Work for My Theme

{% assign your_facebook_url = '' %}
{% assign your_twitter_url = '' %}
{% assign your_instagram_url = '' %}
{% assign your_pinterest_url = '' %}
{% assign your_newsletter_url = '' %}
{% assign your_tumblr_url = '' %}
{% assign your_flickr_url = '' %}
{% assign your_youtube_url = '' %}
{% assign your_vimeo_url = '' %}
{% assign your_skype_username = '' %}

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.

For example:

{% assign your_facebook_url = 'http://facebook.com/myshop' %}
{% assign your_twitter_url = 'http://twitter.com/myshop' %}
{% assign your_instagram_url = '' %}
{% assign your_pinterest_url = '' %}
{% assign your_newsletter_url = 'http://ymlp.com/xgeeqmmqgmgw' %}
{% assign your_tumblr_url = 'http://myblog.tumblr.com/' %}
{% assign your_flickr_url = '' %}
{% assign your_youtube_url = '' %}
{% assign your_vimeo_url = '' %}
{% assign your_skype_username = 'myshop_skype' %}
  1. leave a value blank to exclude it from your social links
  2. always include the complete URL, starting with http://
  3. your_newsletter_url can be used to link to a hosted sign-up form for your newsletter, refer How do I add a newsletter subscription form to my Big Cartel theme?
  4. your_skype_username requires your Skype username and not a URL
  5. your product RSS feed will be included with your social network links if the Products feed option is checked in your Big Cartel admin area Customize design > Customize (customize)

social_icon_size

Defines the size of the icons displayed for your social network links. Valid values are:

  • small – 16px by 16px icons
  • large – 24px by 24px icons

For example:

{% assign social_icon_size = 'large' %}

social_icon_style

Defines the style of icons displayed for your social network links. Valid values are positive integers from 1 to 8.

For example:

{% assign social_icon_style = '3' %}

social_pop_out_menu_title

For themes with a social icon pop-out menu, defines the text used for the main menu link. For example:

{% assign social_pop_out_menu_title = 'Connect' %

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 14: RSS Feed Options Location: Layout page

Note that you must check the Products feed option in your Big Cartel admin area Customize design > Customize (customize) to display the RSS feed link publicly and for the following options to have any effect.

alternative_news_feed_url

By default your RSS feed will display the latest products added to your shop. If you wish to replace your product RSS feed with an alternative feed, e.g. a blog feed, enter the complete feed URL in this option.

For example:

{% assign alternative_news_feed_url = 'http://myblog.tumblr.com/rss' %}

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 15: Global Facebook Like Options Location: Layout page

display_shop_wide_facebook_like

Allows the display of a Facebook Like button on all shop pages (typically located in the header or footer). Valid values are yes or no.

shop_facebook_like_links_to_your_facebook_url

Defines the URL that will be assigned to the Like button, displayed with customer’s Likes and under which your Like count will be collected. Valid values are yes or no.

You should enter yes if you have set your custom option your_facebook_url (see note 13) to a Facebook Page associated with your shop that you are collecting a Like count for.

Otherwise enter no and clicks of your shop-wide Facebook Like button will instead be linked to, and counted under, your shop home page URL.

share_pop_out_menu_title

For themes with a sharing tool pop-out menu, defines the text used for the main menu link. For example:

{% assign share_pop_out_menu_title = 'Share' %

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 16: Global Google Plus Options Location: Layout page

display_shop_wide_google_plus

Allows the display of a Google Plus button on all shop pages (typically located in the header or footer). Valid values are yes or no. The Google Plus count will be assigned to your shop home page.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 17: Newsletter & Search Input Options Location: Layout page

{% assign newsletter_form_action_url = '' %}
{% assign newsletter_email_input_name = '' %}
{% assign newsletter_email_input_placeholder_text = 'Join our newsletter!' %}

These options control the display of your newsletter sign up form on all shop pages (typically located in the header or footer).

{% assign newsletter_form_action_url = '' %}
{% assign newsletter_email_input_name = '' %}

These variables can be extracted from your newsletter sign up form. For example, if you newsletter sign up form is:

<form method="post" action="http://ymlp.com/subscribe.php?id=geeqmmqgmgb">
<input type="text" name="YMP0" size="20" value="Join our newsletter" />
<input type="submit" value="Submit"  />
</form>

then your option values must be set as:

{% assign newsletter_form_action_url = 'http://ymlp.com/subscribe.php?id=geeqmmqgmgb' %}
{% assign newsletter_email_input_name = 'YMP0' %}

Refer to How do I add a newsletter subscription form to my Big Cartel theme? for more details on setting up and using your newsletter service.

newsletter_email_input_placeholder_text

Defines the text that will be displayed in the e-mail address input before a customer clicks it to enter their address. For example:

{% assign newsletter_email_input_placeholder_text = 'Get the latest news via email' %}

newsletter_form_hidden_inputs

Allows the addition of hidden inputs to the newsletter sign up form. Most sign up forms will not use hidden inputs, however some newsletter services (like iContact) depend on them to function.

Leave this option blank if hidden inputs are not required.

Valid values are any input tags provided by your newsletter service. For example:

{% capture newsletter_form_hidden_inputs %}
<input type="hidden" name="listid" value="554433">
<input type="hidden" name="clientid" value="998877">
<input type="hidden" name="formid" value="887766">
{% endcapture %}

newsletter_form_width

Defines the width of the e-mail address input in pixels. Valid values are any positive integer. The default width is applied if the value is left blank.

For example:

{% assign newsletter_form_width = '140' %}

search_form_width

Defines the width of the search input in pixels. Valid values are any positive integer. The default width is applied if the value is left blank. See above example.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 18: Love Options Location: Layout page

{% assign display_footer_aarcade_link = 'yes' %}
{% assign display_footer_big_cartel_link = 'yes' %}

Valid values are:

  • yes – show some Aarcade and/or Big Cartel love by displaying some unobtrusive links in your shop footer
  • no – hide the Aarcade and/or Big Cartel links

We rely strongly on word-of-mouth to maintain our business so, whether you display our links or just tell your friends about us, any mention of us is greatly appreciated!

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 19: Home Page Options Location: Home page

product_image_thumbnail_size

Defines the size of the product images displayed on your shop home page only (see note 20 for setting size on all other products pages). Valid values are:

  • small – images constrained to 175px wide by 175px high
  • medium – images constrained to 225px wide by 225px high
  • portrait – images cropped to 225px wide and constrained to 300px high
  • large – images constrained to 300px wide by 300px high
  • large freeheight – images constrained to 300px wide with height scaled from original image size. This size will be identical to large unless your original images were uploaded with portrait dimensions, i.e. image height is greater than image width.1

1 This size uses the full size product image and therefore may increase the time it takes for your home page to load.

For example:

{% assign product_image_thumbnail_size = 'large freeheight' %}

This option value will also affect the number of images per row, i.e. smaller images equals more images per row and larger images equals less images per row.

To avoid incomplete product image rows, always review / adjust your featured products per page setting after changing this custom option.

If you change these image size custom options, it is recommended that you also make the same changes to your PRODUCTS – plural, not singular – page custom options for consistent display of your images throughout your store (see note 20).

Refer to Big Cartel theme product image preparation and size for important information on establishing high quality and uniform product images.

scale_crop_to_fit_height

Defines the fixed height – in pixels – that all product images on the home page will be set to. When a value is entered in this option, all images will be scaled and cropped to the same dimensions (image width will be per the product_image_thumbnail_size – see previous option).

Valid values are any whole number from 100 to 600. For example:

{% assign scale_crop_to_fit_height = '450' %}

Do not include ‘px’ with the value.

scale_crop_to_fit_position

Defines the vertical alignment of your image when product images are scaled and cropped to fit. This option will only have an affect upon product image appearance if a value for scale_crop_to_fit_height has been set and the height of the product image is being cropped.

Valid values are top, middle or bottom. For example:

{% assign scale_crop_to_fit_position = 'bottom' %}

home_page_products_are

Defines the products that will be displayed on your shop home page. For all values the product order and number per page will be according to the Featured products setting in your Big Cartel admin area Customize design > Customize (customize).

Valid values are:

  • featured – displays featured products
  • all – displays all products with pagination
  • CATEGORYNAME – displays products from a specific category, i.e. enter the desired category name as the option value

For example, if we wanted only products from the category T-Shirts to be displayed on the home page:

{% assign home_page_products_are = 'T-Shirts' %}

hide_sold_out_products

Prevents the display of sold out products on the home page. Valid values are yes or no.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 20: Products Page Options Location: Products page

These settings affect the products pages, i.e. the all-products page, all category pages and the search results page.

product_image_thumbnail_size

Defines the size of the product images displayed on your products pages. Valid values are:

  • small – images constrained to 175px wide by 175px high
  • medium – images constrained to 225px wide by 225px high
  • portrait – images cropped to 225px wide and constrained to 300px high
  • large – images constrained to 300px wide by 300px high
  • large freeheight – images constrained to 300px wide with height scaled from original image size. This size will be identical to large unless your original images were uploaded with portrait dimensions, i.e. image height is greater than image width.1

1 This size uses the full size product image and therefore may increase the time it takes for products pages to load.

For example:

{% assign product_image_thumbnail_size = 'medium' %}

This option value will also affect the number of images per row, i.e. smaller images equals more images per row and larger images equals less images per row.

To avoid incomplete product image rows, always review / adjust your products per page setting after changing this custom option.

If you change these image size custom options, it is recommended that you also make the same changes to your HOME page custom options for consistent display of your images throughout your store (see note 19).

Refer to Big Cartel theme product image preparation and size for important information on establishing high quality and uniform product images.

scale_crop_to_fit_height

Defines the fixed height – in pixels – that all product images on products pages will be set to. When a value is entered in this option, all images will be scaled and cropped to the same dimensions (image width will be per the product_image_thumbnail_size – see previous option).

Valid values are any whole number from 100 to 600. For example:

{% assign scale_crop_to_fit_height = '450' %}

Do not include ‘px’ with the value.

scale_crop_to_fit_position

Defines the vertical alignment of your image when product images are scaled and cropped to fit. This option will only have an affect upon product image appearance if a value for scale_crop_to_fit_height has been set and the height of the product image is being cropped.

Valid values are top, middle or bottom. For example:

{% assign scale_crop_to_fit_position = 'top' %}

hide_sold_out_products

Prevents the display of sold out products on the products pages. Valid values are yes or no.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 21: General Product Page Options Location: Product page

product_image_size

Defines the size of the main product image and the layout columns for the product page. Valid values are:

  • small – main image width is contained to 300px wide by 300px high
  • large – main image width is contained to approximately 480px (may vary depending upon theme) and height is re-sized in proportion to the original product image size

show_prev_next_text_links

Display ← prev and next → links to the surrounding products in the shop. Valid values are yes or no.

enable_image_fade_transition

Enables the fade transition when the main product image is changed (by clicking one of the image thumbnails). Valid values are yes or no.

enable_image_popup_zoom

Enables the pop-up light box viewer used to zoom in on product image detail when the main product image is clicked. Valid values are yes or no.

add_to_cart_location

Defines the location of the add to cart controls (including the add to cart button, option selector, quantity input and inventory table, as applicable). Valid values are:

  • top – above the product description
  • bottom – below the product description

add_to_cart_button_text

Defines the text used for the add to cart button. Valid values are any plain text (do not use code or special characters). For example:

{% assign add_to_cart_button_text = 'Buy' %}

product_thumbnail_location

Defines the location of the product thumbnails used to load product images into the main image area. Valid values are left, middle or right.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 22: Product Selector Options Location: Product page

option_selector_title

This option value will be displayed as a label before the product option selector. For example:

{% assign option_selector_title = 'Select your size:' %}

Leave the value blank to hide the selector label.

option_selector_type

Defines the type of interface provided for customer selection of product options prior to adding to cart. Valid values are:

  • select – standard HTML drop down menu
  • radio – radio button list allows all options to be visible before customer interaction
  • js-select – full width styled drop down menu with editable colours (you should not choose this setting if you have 10 or more product options for any given product)

allow_quantity_selection

Provides an input to allow the customer to select the quantity of items to add to cart at the product page. Valid values are yes or no.

Note that whether this option is enabled or not, the customer will always be able to edit cart quantities at the cart page.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 23: Other Products Options Location: Product page

other_products_are

Defines the products that will be displayed on product pages. Valid values are:

  • none – other products will not be displayed
  • category – other products will be selected from the same sub-category and category that the main product belongs to
  • in-order – other products will be shown in regular order (i.e. the order set in your Big Cartel admin area Products)
  • newest – newest products
  • top-selling – top-selling products
  • on-sale – products labelled on sale
  • CATEGORYNAME – products from the category name entered will be shown, e.g. “Hats”, or a subcategory like “Womens – Pants”, or a hidden category like “x My Other Products” (see example below), etc.

For example:

{% assign other_products_are = 'in-order' %}

Or using a category name:

{% assign other_products_are = 'x My Other Products' %}

other_products_title

If this option is left blank, the title for the other products area will be generated automatically. Entering an option value will replace the automatically generated title. For example:

{% assign other_products_title = 'You may also like...' %}

other_products_location

Defines the location of the other products area. Valid values are left, right or bottom.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 24: Product Sharing Options Location: Product page

share_product_tools

Defines the type of sharing tools to display on the product pages. Valid values are any combination of (separated with a space):

  • like – Facebook Like button
  • share – Facebook Share button
  • tweet – Twitter Tweet button
  • pinit – Pinterest Pin It button (will only be displayed if a product image is available)
  • email – Email button
  • plus – Google Plus button
  • addthis – AddThis multi-share option button

For example, to display a Like button and an AddThis button:

{% assign share_product_tools = 'like addthis' %}

share_product_style

Defines the style of icons displayed for the sharing tool icons. Valid values are 0 – which displays text links instead of icons – or a positive integer from 1 to 8. Note that style options 1 to 8 match the styles for the global social network links, but can be set differently.

For example:

{% assign share_product_style = '3' %}

share_product_size

Defines the size of the icons displayed for the sharing tool icons. Valid values are:

  • small – 16px high
  • large – 24px high

For example:

{% assign share_product_size = 'large' %}

addthis_publisher_id

Enter your AddThis publisher ID to allow yourself to log and view analytics for the use of your product sharing tools. To get an AddThis publisher ID, register at AddThis.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 26: PayPal Payment Options Location: Checkout page

paypal_payment_page_style

Defines the PayPal payment page style to be used for your shop checkout process. PayPal payment page styles are created in your PayPal admin area – refer to How do I customise my PayPal payment page? for more details.

For example:

{% assign paypal_payment_page_style = 'MyShopStyle' %}

customer_note_input_label

Defines the label text for the note input provided to the customer during the payment process. If the option is left blank, the default label “Add special instructions to merchant.” is used.

For example:

{% assign customer_note_input_label = 'Enter your engraving preferences below:' %}

Use only basic punctuation. Maximum characters (including spaces) = 90.

hide_customer_note_input

Hide the “Add special instructions to merchant.” note field from the customer during the payment process. Valid values are yes or leaving the value blank.

shipping_address_is_not_required

The customer will not be asked for a shipping address during the payment process under any circumstances. Valid values are yes or leaving the value blank.

This value is useful for shops dealing in digital products only.

return_after_payment_link_text

Defines the text used to link the customer back to your shop success page after payment has been successfully completed. If the option is left blank, the default label “Return to STORENAME” is used (where STORENAME is the name of your shop defined in your Big Cartel admin area Store > Setttings – Basics section).

For example:

{% assign return_after_payment_link_text = 'RETURN TO AARCADE TO COMPLETE YOUR ORDER PROCESS' %}

Avoid using punctuation. Maximum characters (including spaces) = 60.

return_after_payment_link_url

By default, the customer will be linked back to your success page after payment has been completed, e.g. http://myshop.bicartel.com/success

To define an alternative URL for this return link, enter a complete and valid public URL for this option value. For example:

{% assign return_after_payment_link_url = 'https://mysite.com/my-secure-receipt-page' %}

This option is useful for creating a secure receipt page, at location separate from your Big Cartel shop, that will make use of the customer’s order details, e.g. for sending automated e-mails, for logging affiliate details, etc.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 27: Checkout Message Options Location: Checkout page

checkout_page_title

This option value is the title of the message displayed to the customer at the checkout processing page, i.e. before the PayPal payment page is presented to the customer.

For example:

{% assign checkout_page_title = 'We're Processing Your Order' %}

checkout_page_message

Defines additional text content for the message displayed to the customer at the checkout processing page, i.e. before the PayPal payment page is presented to the customer.

For example:

{% capture checkout_page_message %}
Please wait a moment while we process your cart
and load your secure payment page.

<i>MyShop is a Little Cog Venture.</i>
{% endcapture %}

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 28: Success Message Options Location: Success page

success_page_title

This option value is the title of the message displayed to the customer at the success page, after their payment has been successfully completed.

For example:

{% assign checkout_page_title = 'Thank You!' %}

success_page_message

Defines the content for the message displayed to the customer at the success page, after their payment has been successfully completed.

For example:

{% capture success_page_message %}
Your order has been successfully placed, and a receipt for your purchase has been emailed to you.

We'll start working on delivery as soon as possible. Please <a href="/contact">contact us</a> if you have any questions or concerns.

<b>We sincerely appreciate your business.</b>
{% endcapture %}

Your success page message should:

  • Help the customer understand that the payment has been made and that the transaction has been completed
  • Explain that payment transaction details will be emailed to the customer
  • Optional: Provide a method for the customer to contact you if required

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 29: Contact Form Options Location: Contact page

contact_form_introduction

This option value is the text that is displayed before the contact form on the contact page. For example:

{% capture contact_form_introduction %}
Use the form below to send us a note. We'd love to hear from you!
{% endcapture %}

contact_form_submitted_message

This option value is the text that is displayed to the customer after they have submitted a message with the contact form on the contact page. For example:

{% capture contact_form_submitted_message %}
Thanks for sending us a note. We'll get back to your shortly.
{% endcapture %}

additional_text_after_form

Defines additional text to be displayed after the contact form on the contact page. For example:

{% capture contact_form_submitted_message %}
<span style="color: #cc0000;">Please double check your e-mail address before submitting your form!</span>
{% endcapture %}

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 30: Contact Page Content Options Location: Contact page

show_center_border

Hide the border that separates the left column from the right on the product page. Valid values are yes or no.

Note that the right column is only displayed if the following options are used to generate right column content.

full_street_address_label

This option value is the text that will appear before your full street address. For example:

{% assign full_street_address_label = 'Our Shop Location:' %}

Leave the option value blank to hide the label.

full_street_address

Enter your street address to display it publicly in the right column of your contact page. It is recommended that you enter your address in strict accordance with your local postal address standards. For example:

{% capture full_street_address %}
404 NW 10th Ave
Portland, OR 97214
United States
{% endcapture %}

full_postal_address_label

This option value is the text that will appear before your full postal address. Leave the option value blank to hide the label.

full_postal_address

Enter your postal address to display it publicly in the right column of your contact page. It is recommended that you enter your address in strict accordance with your local postal address standards.

right_column_text

Defines additional text to be displayed in the right column of the contact page. For example:

{% capture right_column_text %}
Mon - Fri: 8am - 5pm 
Sat: 10am - 4pm 
Sun: Closed

PH: 555 555 5555
{% endcapture %}

Your contact page form is used to send messages to your e-mail address so, while it is an option, it is recommended that you do not include your e-mail on the contact page. Displaying your e-mail address publicly will likely result in an increase in spam.

show_google_map

Display a Google map for your street address (see above) in the right column of your contact page. Valid values are yes or no.

google_map_is_interactive

Defines whether the Google map is a static image (clicking the image launches Google Maps in a new window) or is an interactive map (with zoom and pan controls). Valid values are yes or no.

google_map_zoom_level

Defines the zoom level of the Google map displayed on the contact page. Valid values are any integer from 4 to 20.

google_map_address

In some cases your Google map may not display correctly based upon the street address entered in your full_street_address option. The google_map_address can be used in this case to override the street address. This allows you to experiment with address details and formats to fine tune your contact page Google map.

Use Google Maps to help define an accurate address for your location. If text addresses are not successful, you may enter your latitude and longitude as the option value. For example:

{% capture google_map_address %}
45.552736, -122.675550
{% endcapture %}

Refer to How do I look up latitude and longitude coordinates on Google Maps?

additional_text_after_map

Defines additional text to be displayed after the Google map on the contact page.

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 31: Maintenance Message Options Location: Maintenance page

maintenance_page_message

Defines the content for the message displayed to the customer when your shop is in maintenance mode – refer to How does maintenance mode work?

For example:

{% capture maintenance_page_message %}
We're currently restocking the shop.

Follow our blog at <a href="http://myshop.tumblr.com/">http://myshop.tumblr.com</a> 
to get an update when we re-open.
{% endcapture %}

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 32: Cart Page Options Location: Cart page

enable_auto_update_after_country_select

Enables automatic cart update immediately after the customer selects their country (as opposed to clicking the “Update Cart” button). Valid values are yes or no.

checkout_button_text

Defines the text used for the checkout button. Valid values are any plain text (do not use code or special characters). For example:

{% assign checkout_button_text = 'Proceed With Payment' %}

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 33: Global Layout Options Location: Layout page

enable_responsive_layout

Enables a responsive layout globally. A responsive layout dynamically adapts to the size of a screen (i.e. iPhone, iPad, Laptop, etc.) to optimise usability at that size. Valid values are yes or no.

animate_public_notice

Allows your customer to toggle the public notice open and closed. Valid values are yes or no.

Public notices are added via the x ic public notice insert content method – refer to Insert Content

slim_sidebar

Enables extra slim sidebar – on some themes with a sidebar area – to allow a wider product area with more product thumbnails per row (i.e. more columns) in product grid view pages. Valid values are yes or no.

If you do enable this option, we recommend that you reduce the font size in your sidebar menus – refer to How do I edit my Big Cartel theme fonts?

If your theme has a sidebar and you do not have this option, your theme may have a sidebar width setting in your Extra Styles section – refer to What are the Extra Styles for my Aarcade Big Cartel theme?

To Top of Page | This is Missing or Doesn't Work for My Theme

Note 34: Customer Product Notes Location: Checkout page

Refer to How do I allow customers to enter product notes during checkout with Big Cartel? for more details on these options.

customer_product_notes_intro

Defines the content for the introductory message displayed if customer product notes are requested during checkout.

For example:

{% capture success_page_message %}
<div style="text-align:center;"><img src="http://mydropbox.com/my-little-logo.jpg" /></div>

Some of your products have custom options. Please complete the following items before proceeding to checkout.
{% endcapture %}

customer_product_notes

Defines the input fields, and their relationship to your products, for collecting customer information during the checkout process. This custom option uses Aarcade shortcode format to allow maximum flexibility. It is therefore recommended that you read An Introduction to Shortcodes before proceeding.

A simple example:

{% capture customer_product_notes %}
[[note title="Engraving Text" category="Bracelets"]]
Please enter your custom engraving text below.

Important Note: Your text must be less than 60 characters.
[[/note]]
{% endcapture %}

Refer to How do I allow customers to enter product notes during checkout with Big Cartel? for complete details on creating multiple notes and setting category, title and other options.

submit_button_text

Defines the text used for the submit button, i.e. to proceed with checkout after entering notes. Valid values are any plain text (do not use code or special characters). For example:

{% assign submit_button_text = 'Submit My Notes' %}

To Top of Page | This is Missing or Doesn't Work for My Theme