Experience slot search parameters

country

Accepts any of the Easol predefined countries as either Country Codes or Country Names. This can be passed as a Liquid variable or explicitly.

Will accept either a single country or an array. An array must be passed explicitly (not as a Liquid variable).

Will return experience slots where the product’s location match the country passed.

as a search tag attribute

{% experience_slot_search country: 'FR' %}
{% endexperience_slot_search %}

{% experience_slot_search country: ['FR','DE'] %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[country]=DE

departure_date

Accepts an object which specifies how to handle the search through equal_to greater_than greater_or_equal_than or less_than each taking a date in SQL format YYYY-MM-DD. The date(s) can be passed as a Liquid variable or explicitly.

Will return experience slots which depart within the departure date range.

as a search tag attribute

{% experience_slot_search departure_date: { greater_or_equal_than: 'now', less_than: '2023-12-28' } %}
{% endexperience_slot_search %}

passing a Liquid variable

{% assign latest_date = opt_selected_by_user %}

{% experience_slot_search departure_date: { greater_or_equal_than: 'now', less_than: latest_date } %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[departure_date][greater_or_equal_than]=2022-11-19&search[departure_date][less_than]=2023-12-28

departure_month

Accepts a month as either a 3-letter abbreviation, or the month number i.e. Apr or 4. This can be passed as a Liquid variable or explicitly.

Will return experience slots which depart within the specified month, this may be across multiple years e.g. Apr 2023 and Apr 2024.

as a search tag attribute

{% experience_slot_search departure_month: 'Apr' %}
{% endexperience_slot_search %}

{% experience_slot_search departure_month: 4 %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[departure_month]=Apr
https://mysite.com/search?search[departure_month]=4

duration

Accepts an object which specifies how to handle the search, through equal_to greater_than or less_than each taking a number of days. The value(s) can be passed as a Liquid variable or explicitly.

Will return experience slots which have a duration within the defined range.

Note: Experience durations can be returned as a number of hours, 1 day or a number of nights, whereas experience_slot_search duration will by default always take the duration as a number of days or number of hours. i.e. duration: {equal_to: 2} will return experience slots that have a duration of 2 hours or 1 night (2 days). To specify a diferent duration, one can pass the a duration_unit alongside the duration, the accepted values as day, hour or minute.

as a search tag attribute

{% experience_slot_search duration: {greater_than: 3, less_than: 8 }, duration_unit: "hour" %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[duration][greater_than]=3&search[duration][less_than]=8&search[duration_unit]=hour

duration_unit

To be used in combination with duration. This value can be: day, hour and minute. When no value passed it defaults to day.

exclude_sold_out_products

Accepts: true or false. This can be passed as a Liquid variable or explicitly.

Passing true will exclude sold out experience slots where all variants for this slot are sold out, i.e. all stock is sold or they have been manually marked as ‘Sold Out’. Any slot in the past is also considered sold out.

as a search tag attribute

{% experience_slot_search exclude_sold_out_products: true %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[exclude_sold_out_products]=true

name

Executes a partial search on the string passed in. Case insensitive. This can be passed as a Liquid variable or explicitly.

Will return any products whose name matches the argument.

as a search tag attribute

{% experience_slot_search name: 'my experience' %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[name]=my+experience

product_id

Will accept either a single product id or an array. This can be passed as a Liquid variable or explicitly.

Will return slots for only the product ids passed.

as a search tag attribute

{% experience_slot_search product_id: 'abcd1234-1234-abcd-1234-abcd1234abcd' %}
{% endexperience_slot_search %}

{% experience_slot_search product_id: ['abcd1234-1234-abcd-1234-abcd1234abcd', 'wxyz9876-9876-wxyz-9876-wxyz9876wxyz'] %}
{% endexperience_slot_search %}

{% assign product_ids = products | map: "id" %}
{% experience_slot_search product_id: product_ids %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[product_id]=abcd1234-1234-abcd-1234-abcd1234abcd

subcategory

Accepts a string and is case-sensitive. This can be passed as a Liquid variable or explicitly.

Will accept either a single subcategory or an array. An array must be passed explicitly (not as a Liquid variable).

Will return experience slots where the subcategory matches the subcategory passed.

as a search tag attribute

{% experience_slot_search subcategory: 'Wellness' %}
{% endexperience_slot_search %}

{% experience_slot_search subcategory: ['4 Star','5 Star'] %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[subcategory]=wellness

page_size

Accepts a number. This can be passed as a Liquid variable or explicitly.

Will determine how many results are shown per page. If this is not included it will default to 12 results per page.

Page size cannot be passed as a query parameter.

as a search tag attribute

{% experience_slot_search page_size: 8 %}
{% endexperience_slot_search %}

sort

Accepts name_asc, name_desc, duration_asc, duration_desc, departure_date_asc and departure_date_desc, where the _asc and _desc parts represent ascending and descending orders respectively. This can be passed as a Liquid variable or explicitly.

Will determine the order of the returned experience slots.

as a search tag attribute

{% experience_slot_search sort: `departure_date_asc` %}
{% endexperience_slot_search %}

as a query parameter

https://mysite.com/search?search[sort]=departure_date_asc