> ## Documentation Index
> Fetch the complete documentation index at: https://beacon.shiptoall.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shipping Events

#### How Events Work

Shipping Events define a set of optional shipping rules that determine when and which shipping costs appear during checkout.

They include various service types—such as free shipping, carrier-based rates, and custom rates—allowing merchants to calculate shipping based on over 35 different conditions, including location, order details, and other criteria.

#### Create a event

<Card title="Shiptoall -> Shipping Events">
  Let's create a single event to test your setup.

  <Info>Events are required to have at least one service method. We can set this up in the next steps.</Info>

  <Steps>
    <Step title="Click the 'Create Event' Button">
      * Enter a name for your event (for example, **"USA Custom Shipping"**).
    </Step>

    <Step title="Create Event conditions ( Optional )">
      <Tip>Only add conditions if you want to limit when this **event** is triggered. Multiple conditions can be added. See the properties section for each detailed condition.</Tip>
    </Step>

    <Step title="Create Service methods">
      <Tip>Service methods define how shipping costs are calculated for this event. You can create multiple service methods with different configurations for different locations.</Tip>

      * For testing purposes, you can set up a custom **Table Rates** service method.

      See the service methods documentation for more details.
    </Step>
  </Steps>
</Card>

#### Properties

<ResponseField name="Conditions" type="Event Conditions">
  <ResponseField name="Product Tags">
    Filter shipping events based on specific product tags present in the cart.

    Comma-separated multiple values accepted (e.g., tag1, tag2, tag3)
  </ResponseField>

  <ResponseField name="Product Vendor">
    Restrict shipping events to products from selected vendors.
    Multiple vendors can be selected.
  </ResponseField>

  <ResponseField name="Product Title">
    Trigger shipping events for products with matching titles.

    Comma-separated multiple values accepted (e.g., title1, title2, title3)
  </ResponseField>

  <ResponseField name="Product Sku">
    Trigger shipping events based on products with specified SKUs.

    Comma-separated multiple values accepted (e.g., sku1, sku2, sku3)
  </ResponseField>

  <ResponseField name="Product Collections">
    Limit shipping events to products within certain collections. Multiple collections can be selected.
  </ResponseField>

  <ResponseField name="Product Type">
    Filter shipping events by product type. Multiple product types can be selected.
  </ResponseField>

  <ResponseField name="Product Properties">
    Use custom product properties to determine event eligibility. Property key and value pairs are required
  </ResponseField>

  <ResponseField name="Product Quantity">
    Trigger shipping events based on the total quantity of products in the cart.
  </ResponseField>

  <ResponseField name="Product Price">
    Trigger shipping events based on the price of unique products in the cart.
  </ResponseField>

  <ResponseField name="Product Total">
    Trigger shipping events based on the total price of unique products in the cart.
  </ResponseField>

  <ResponseField name="Product Weight">
    Trigger shipping events by the  total weight of unique products in the cart.
  </ResponseField>

  <ResponseField name="Product Volume">
    Restrict shipping events based on the combined volume of products.
  </ResponseField>

  <ResponseField name="Product Length">
    Restrict shipping events based on combined product length of unique products in the cart.
  </ResponseField>

  <ResponseField name="Product Width">
    Restrict shipping events based on combined product width of unique products in the cart.
  </ResponseField>

  <ResponseField name="Product Height">
    Restrict shipping events based on combined product height of unique products in the cart.
  </ResponseField>

  <ResponseField name="Product Packing">
    Trigger shipping events depending on product packing method.
  </ResponseField>

  <ResponseField name="Product Custom Ship">
    Trigger event depending on custom shipping attributes set on products.
  </ResponseField>

  <ResponseField name="Product Pieces">
    Trigger shipping events based on product with additional pieces.
  </ResponseField>

  <ResponseField name="Customer Tags">
    Filter shipping events for customers with specific tags.
  </ResponseField>

  <ResponseField name="Customer Postal Code">
    Trigger shipping events to customers in certain postal codes.
  </ResponseField>

  <ResponseField name="Customer Address">
    Trigger shipping events based on customer address details.
  </ResponseField>

  <ResponseField name="Customer City">
    Apply shipping events for customers in specific cities.
  </ResponseField>

  <ResponseField name="Customer Postal Box">
    Filter shipping events for customers using postal boxes.
  </ResponseField>

  <ResponseField name="Customer Company">
    Restrict shipping events to customers associated with certain companies.
  </ResponseField>

  <ResponseField name="Customer Name">
    Use customer names as a condition for shipping events.
  </ResponseField>

  <ResponseField name="Customer Email">
    Trigger shipping events for customers with specific email addresses.
  </ResponseField>

  <ResponseField name="Customer Order Count">
    Trigger shipping events based on the total number of orders a customer has placed.
  </ResponseField>

  <ResponseField name="Customer Order Total">
    Trigger shipping events according to the total value of a customer's previous orders.
  </ResponseField>

  <ResponseField name="Cart Quantity">
    Filter shipping events by the total quantity of items in the cart.
  </ResponseField>

  <ResponseField name="Cart Total">
    Trigger shipping events based on the total cart value.
  </ResponseField>

  <ResponseField name="Cart Weight">
    Trigger shipping events for carts based on combined weight.
  </ResponseField>

  <ResponseField name="Cart Volume">
    Trigger shipping events based on the total volume of the cart.
  </ResponseField>

  <ResponseField name="Cart Length">
    Trigger shipping events based on the total length of items in the cart.
  </ResponseField>

  <ResponseField name="Cart Width">
    Trigger shipping events based on the total width of items in the cart.
  </ResponseField>

  <ResponseField name="Cart Height">
    Filter shipping events by the total height of items in the cart.
  </ResponseField>

  <ResponseField name="Delivery Date">
    Trigger shipping events for orders scheduled for specific delivery dates.
  </ResponseField>

  <ResponseField name="Delivery Day">
    Apply shipping events based on the day of the week for delivery.
  </ResponseField>

  <ResponseField name="Delivery Distance">
    Trigger shipping events to deliveries within a certain distance.
  </ResponseField>

  <ResponseField name="Current Date">
    Use the current date as a condition for shipping events.
  </ResponseField>

  <ResponseField name="Current Day of week">
    Filter shipping events by the current day of the week.
  </ResponseField>
</ResponseField>