Available Variables

This document is for a version of Craft Commerce that is no longer supported. Please refer to the latest version →

The following are common methods you will want to call in your front end templates:

# craft.commerce.settings

To get the Craft Commerce general settings model:

{% set settings = craft.commerce.settings %}

# craft.orders()

See Order Queries.

# craft.products()

See Product Queries.

# craft.subscriptions()

See Order Queries.

# craft.variants()

See Variant Queries.

# craft.commerce.carts.cart

See craft.commerce.carts.cart

# craft.commerce.countries.allCountries

Returns an array of craft\commerce\models\Country (opens new window) objects.

<select>
{% for country in craft.commerce.countries.allCountries %}
  <option value="{{ country.id }}">{{ country.name }}</option>
{% endfor %}
</select>

# craft.commerce.countries.allCountriesAsList

Returns a list usable for a dropdown select box.

Data returned as [32:'Australia', 72:'USA']

<select>
{% for id, countryName in craft.commerce.countries.allCountriesAsList %}
  <option value="{{ id }}">{{ countryName }}</option>
{% endfor %}
</select>

# craft.commerce.states

Returns an array of craft\commerce\models\State (opens new window) objects.

<select>
{% for state in craft.commerce.states %}
  <option value="{{ state.id }}">{{ state.name }}</option>
{% endfor %}
</select>

# craft.commerce.states.allStatesAsList

Returns an array of craft\commerce\models\State (opens new window) object arrays, indexed by country IDs.

Data returned as [72:[3:'California', 4:'Washington'],32:[7:'New South Wales']]

<select>
{% for countryId, states in craft.commerce.states.allStatesAsList %}
  <optgroup label="{{ craft.commerce.countries.countriesAsList[countryId] }}">
    {% for stateId, stateName in craft.commerce.states.allStatesAsList[countryId] %}
      <option value="{{ stateId }}">{{ stateName }}</option>
    {% endfor %}
  </optgroup>
{% endfor %}
</select>

# cart.availableShippingMethods

Returns the shipping methods available to applied to the current cart. Will not include some shipping methods if none of the shipping method’s rules can match the cart.

{% for handle, method in cart.availableShippingMethods %}
  <label>
    <input type="radio" 
           name="shippingMethodHandle" 
           value="{{ handle }}"
           {% if handle == cart.shippingMethodHandle %} checked{% endif %}
    />
    <strong>{{ method.name }}</strong> {{ method.priceForOrder(cart)|currency(cart.currency) }}
  </label>
{% endfor %}

# craft.commerce.gateways.allFrontEndGateways

Returns all payment gateway available to the customer.

{% if not craft.commerce.gateways.allFrontEndGateways|length %}
  <p>No payment methods available.</p>
{% endif %}

{% if craft.commerce.gateways.allFrontEndGateways|length %}
<form method="post" id="paymentMethod" class="form-inline">
  <input type="hidden" name="action" value="commerce/cart/update-cart">
  <input type="hidden" name="redirect" value="commerce/checkout/payment">
  {{ getCsrfInput() }}

  <label for="">Payment Method</label>
  <select id="gatewayId" name="gatewayId" class="form-control" >
    {% for id,name in craft.commerce.gateways.allFrontEndGateways %}
      <option value="{{ id }}" {% if id == cart.gatewayId %}selected{% endif %}>{{ name }}</option>
    {% endfor %}
  </select>
</form>
{% endif %}

# craft.commerce.taxCategories.allTaxCategories

Returns an array of all tax categories set up in the system.

{% for taxCategory in craft.commerce.taxCategories.allTaxCategories %}
  {{ taxCategory.id }} - {{ taxCategory.name }}
{% endfor %}

# craft.commerce.productTypes.allProductTypes

Returns an array of all product types set up in the system.

{% for type in craft.commerce.productTypes.allProductTypes %}
  {{ type.handle }} - {{ type.name }}
{% endfor %}

# craft.commerce.orderStatuses.allOrderStatuses

Returns an array of craft\commerce\models\OrderStatus (opens new window) objects representing all the order statuses in the system.

{% for status in craft.commerce.orderStatuses.allOrderStatuses %}
  {{ status.handle }} - {{ status.name }}
{% endfor %}

# craft.commerce.discounts.allDiscounts

Returns an array of all discounts set up in the system.

{% for discount in craft.commerce.discounts.allDiscounts %}
  {{ discount.name }} - {{ discount.description }}
{% endfor %}

# craft.commerce.discounts.getDiscountByCode(code)

Returns a discount that matches the code supplied.

{% set discount = craft.commerce.discount.getDiscountByCode('HALFOFF') %}
{% if discount %}
  {{ discount.name }} - {{ discount.description }}
{% endif %}

# craft.commerce.sales.allSales

Returns an array of all sales set up in the system.

{% for sale in craft.commerce.sales.allSales %}
  {{ sale.name }} - {{ sale.description }}
{% endfor %}