Extras: Wholesale Order Form

Set Custom Options

Review and set the Wholesale Form page Custom Options, located at the top of the page code, referring to the following notes (for more information on correctly setting custom options, refer to the last sections – starting at Working With Assign-Type Custom Options – of the support article How do I use the Custom Options for my Big Cartel theme?).

IMPORTANT TIP: Clicking the full screen icon () in your Big Cartel page customisation area will allow you to view and work with your custom options more easily.

{{ REQUIRED SETTINGS }}

big_cartel_domain

Your Big Cartel Store domain is required to correctly load your product details into your wholesale form. If you are not sure what your store domain value is, navigate to the Store > Settings area in your Big Cartel admin, scroll down to the Domains section and find the value as follows:

For this example our custom option should be set as follows:

{% assign big_cartel_domain = 'myshop' %}

If your subdomain is not valid, your wholesale form page will display the message “Some critical form settings are missing. Please refer to the installation instructions.“.

{{ TITLES & CONTENT }}

form_intro

Defines content to be displayed at the top of the page, before the wholesale form. This will only be displayed if the form is successfully loaded with products.

Valid values are any text or HTML. For example:

{% capture form_intro %}
<h1>{{ store.name }} - Wholesale Order Form</h1>

Welcome to our wholesale order form. Fill in the quantities as needed and click the "Add All To Cart" button when you are ready.
{% endcapture %}

Note that in the above example we have used the {{ store.name }} Big Cartel API variable for automatically displaying our store name and a h1 heading tag for the title.

Single and double returns (i.e. new lines) will automatically be turned into line breaks and paragraphs respectively.

add_to_cart_notes

Defines content to be displayed immediately before the “Add All To Cart” button within the wholesale form.

Valid values are any text or HTML. For example:

{% capture add_to_cart_notes %}
IMPORTANT: Shipping costs will be added when you select your destination country at the cart page.
{% endcapture %}

See form_intro notes for more information on using HTML content.

form_outro

Defines content to be displayed at the bottom of the page, after the wholesale form. This will only be displayed if the form is successfully loaded with products.

Valid values are any text or HTML. See form_intro notes for more information on using HTML content.

pop_up_image_viewer_colour

Defines the colour scheme for the pop-up light box viewer used to display product images. 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

Note, if you have an Aarcade theme, your global light box style setting will override your setting for this option. In this case, you can ignore this option.

{{ STORE & PRODUCTS }}

enable_inventory_management

Defines whether your have inventory controls enabled or disabled for your shop, i.e. product order quantities are limited to the quantities in stock. This is not an override setting. It must be set to match your store settings.

Valid values are yes or no.

wholesale_discount_percentage

Defines the percentage discount that will be applied to the pricing of all products in your wholesale form.

Note that the form discount percentage and your Big Cartel discount code are limited to one percentage discount value across all products. In other words, you can not apply different discounts for different products / categories or use shipping or flat-rate discounts. If you need more control over your wholesale pricing and products than allowed by a blanket percentage discount, refer to the section Other ways to use the wholesale form below.

Valid values are any whole number from 1 to 99. Do not enter the % sign. For example:

{% assign wholesale_discount_percentage = '25' %}

The discount percentage value is used as follows:

• Discounted values are displayed for all product item prices and totals.
• The original product item price is displayed underneath the discounted item price in a smaller font and with a line through it.
• If the corresponding discount code, set in your Big Cartel Promote > Discounts admin section, is the same as the value you have set for your password_phrase (see USERNAME PROTECTED section below) then the discount code will be activated automatically before taking the customer to the cart page.
• If you have not set a password_phrase, or the corresponding discount code is different to the password_phrase, the customer will be prompted to enter their discount code before they are taken to the cart page.

If you are particularly concerned about unauthorised people attempting to access your form to gain a discount, then we recommend that you DO NOT set your password_phrase the same as your discount code. That said, unauthorised orders using the discount code can simply be cancelled and refunded.

minimum_order_value

Defines the minimum order value that must be reached before the order can be submitted. Leave this setting blank if you do not want to set a minimum order value. Otherwise enter a whole number without a currency symbol. For example, if you wish to set a minimum order of $1,450.00:

{% assign minimum_order_value = '1450' %}

If you are also applying a discount percentage (see previous option) it is recommended that you set the same minimum value for your discount code in your Big Cartel Promote > Discounts admin section. This is done via the first option for your discount code, i.e. When a customer – spends at least $______ – your discount minimum value must match your minimum_order_value setting.

Refer to Discount codes – Big Cartel Manual.

hide_sold_out_products

Defines whether sold out products are displayed within the wholesale form. Valid values are yes or no.

hide_coming_soon_products

Defines whether coming soon products are displayed within the wholesale form. Valid values are yes or no.

include_or_exclude_category_list

Defines whether products belonging to the categories included in the category list (see next option) are included or excluded from the wholesale form. Valid values are:

• include – only products belonging to the categories in the category list will be displayed
• exclude – only products NOT belonging to the categories in the category list will be displayed

This option has no effect if the following option is left blank.

category_list

A comma separated list of categories used to include or exclude products from the wholesale form (see previous option). Valid values are any category name (including any Aarcade extended category control prefixes if applicable).

Leave this option blank if you want all categories displayed. Note that even Aarcade hidden categories will be displayed in this case (i.e. the Aarcade x, xa, xb and xc categories are for hiding products from your public shop menu and pages, not from your wholesale form). This is intentional, as it provides you with the most flexibility for including or excluding any product categories in your wholesale form using this category_list option.

For example:

{% capture category_list %}
Bags, Hats, xc Wholesale Products
{% endcapture %}

show_per_product_categories

Defines whether a list of the categories a product belongs to is displayed at the bottom of each product entry. Valid values are yes or no.

Clicking categories will filter the form to show only items in that category.

order_by_category

Defines whether your products are displayed in the order you have set manually in your Products Big Cartel admin area or grouped and ordered by product category. Valid values are yes or no.

{{ USERNAME PROTECTED }}

password_phrase

Defines whether your wholesale form will be password protected or not. Valid values are any sequence of characters without a space. Leave value blank to disable password protection. For example:

{% assign password_phrase = 'password123' %}

Remember that you can set this password phrase to the same phrase as your discount code (if applied) to ensure that your customer does not need to enter the discount code again during order process – see the wholesale_discount_percentage instructions above.

sign_in_intro

Defines content to be displayed before the wholesale form sign in. This will only be displayed if the form is password protected and the password has not yet been entered by the customer (see previous option).

Valid values are any text or HTML. For example:

{% capture sign_in_intro %}
<h1>Wholesale Orders</h1>

For access to our wholesale order form, please enter your account password below. If you do not have a password, please feel free to [[requestlink: submit a wholesale account request]].
{% endcapture %}

Note that you can use the [[requestlink: link text]] shortcode in this option to link to your contact form. If you choose to use this shortcode, always enter it in the correct format and only change the link text:

{% capture sign_in_intro %}
[[requestlink: this is my link text]]
{% endcapture %}

See form_intro notes for more information on using HTML content.

request_link_subject

Defines the text that will be entered into the contact form subject field when a customer uses the request link (see previous option sign_in_intro). Valid values are any text (do not use HTML or line breaks). For example:

{% assign request_link_subject = 'Wholesale Order Request' %}

request_link_message_intro

Defines the initial text that will be entered into the contact form message field when a customer uses the request link (see previous option sign_in_intro). For example:

{% assign request_link_message_intro = 'Please enter the details of your business below:' %}

{{ LOVE }}

display_made_with_aarcade_link

{% assign display_made_with_aarcade_link = 'yes' %}

Valid values are:

• yes – show some Aarcade love by displaying an unobtrusive link in your form sign in and footer
• no – hide the Aarcade link

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!

Style

Depending upon your theme, you may need to add CSS styles to make your order form text legible. For example, you could start by pasting the following into your custom style coding area to make all of your order form text white:

/* - - - - Aarcade Wholesale Form Text Colour */
#aarcade_wh,
#aarcade_wh table {
	color: #ffffff;
	}

For more information on creating your own CSS styles, refer to How do I create custom override styles?

Other ways to use the wholesale form

If you need further control over your wholesale pricing and products, here are some additional suggestions for using your wholesale form.

Aarcade Theme Extended Category Controls

If you have an Aarcade standard theme, you can use your Extended Category Controls to create an xc product category, for example:

xc Wholesale Products

All products you add to this category will be hidden from your public pages, so you can now create wholesale-specific products with the pricing and details you require and add them to your xc product category.

For example: if you have a product called “Blue Shirt”, you might create a new product called “Blue Shirt – Wholesale” and add it to the xc Wholesale Products and assign the lower pricing and shipping for wholesale accordingly. Using this method you do not need to apply a discount code because your pricing is already at wholesale, or you can apply a discount specific to wholesale orders (like a discount or free shipping after a certain order value has been exceeded).

You can then have your wholesale form display only products from your xc product category using the category_list custom option explained previously in this article. For example:

{% assign include_or_exclude_category_list = 'include' %}

{% capture category_list %}
xc Wholesale Products
{% endcapture %}

In this case, you should password protect your form so that the public can not see the details of your wholesale products.

Aarcade Theme – Hiding the Wholesale Form Link

If you have an Aarcade standard theme, you can remove the link to your wholesale form page from your shop navigation so you futher reduce the visibility to your general customers. You can then provide the hidden link to your wholesale customers as required.

To hide your wholesale form page link refer to section Excluding Page Links of our support article How do I control the page navigation in my Big Cartel shop?

Submitting Orders Via E-mail

If you need to allow your customers the option to submit orders via email (for formal invoicing and payment via cheque, etc.), refer to our support article How do I allow my customers to email their orders? IMPORTANT: Note that this method works at your Cart page and is completely independent of your wholesale form. However, you can ensure that the email option is displayed only to your wholesale customers by referring to the section Controlling who sees the email order message of the same article.

Multiple Wholesale Customer Groups

If you have multiple wholesale customer groups, and each require a different percentage discount, you can install your wholesale order form on multiple pages without needing to repurchase the form from Aarcade. As long you do not install onto more than one Big Cartel shop account, this complies with your single wholesale form license.

So, for example, you might create two new pages called Wholesale Orders USA and Wholesale Orders International and then install the wholesale form to each page (per the installation instructions), setting a different login password and a different discount percentage and code for each.

If you have an Aarcade theme, you could also organise all of your wholesale order forms under one drop down menu – see section Moving Page Links to a Sub-page Menu of How do I control the page navigation in my Big Cartel shop?

Wholesale Big Cartel Shop

To have maximum control over your wholesale products and pricing, you can sign up for a new Big Cartel account, separate from your existing shop, and dedicate this new shop entirely to your wholesale products.

With your new shop you can:

• Remove the ability for the public to add your products to the cart by deleting all of the contents of your Customize design > Advanced – Product (singular, not plural) theme page.
• Make the wholesale form your main front page by installing it to your Customize design > Advanced – Home theme page (replacing ALL existing content). For some themes you may need to leave the outermost div tag to avoid breaking the layout, for example with Big Cartel’s Sidecar theme:

  <div id="home_page">
  
  ..insert your complete wholesale form code here..
  
  </div>

• Optional: Remove the ability for the public to browse your wholesale products by deleting all of the contents of your Customize design > Advanced – Products (plural, not singular) theme page.
• Optional: Since the intention is to remove all product browsing from your shop and replace it with the combination of the wholesale form and cart page, you should hide your product category menu as these links will become useless and confusing. This can be done simply via custom CSS. For example:
  • To hide the category menu on an Aarcade theme you can add the following to your custom style coding area:

    /* Hide product category menu for an Aarcade theme */
    #category_nav_menu.nav_menu {
    	display: none;
    	}

  • To hide the category menu on Big Cartel’s Sexy theme you can add the following to your custom style coding area..

    /* Hide product category menu for Big Cartel's Sexy theme */
    #categories.pod {
    	display: none;
    	}

    ..or for Big Cartel’s Block theme..

    /* Hide product category menu for Big Cartel's Block theme */
    #pod_categories.pod {
    	display: none;
    	}

    ..or for Big Cartel’s Sidecar theme..

    /* Hide product category menu for Big Cartel's Sidecar theme */
    #product_nav_list {
    	display: none;
    	}

  • For other themes refer to How do I create custom override styles?

With a dedicated wholesale shop, you can now set all of your details, pricing, shipping costs, etc. to your preferred wholesale values, on a per product basis.

With this option, and all of the above steps applied, you do not need:

• An Aarcade theme to hide products from the public, because all products will be hidden from the public if you password protect your form.
• Discount codes, because all of your pricing and shipping is set to wholesale values already. However you may still choose to apply a discount specific to wholesale orders (like a discount or free shipping after a certain order value has been exceeded).
• To include or exclude product categories – see category_list in the option instructions above – because all of your shop products and categories are dedicated to wholesale. However you may still choose to use this option to hide products from your wholesale customers while they are getting ready for release, temporarily unavailable, etc..