Generates a list of items that are assigned to the "Freebies" section in Maropost Commerce Cloud


[%free_gifts id:'[@sku@]'%]
    [%PARAM *header%]
        <h4>Free gifts</h4>
    [%param *footer%]


To utilize this function, you must have the Freebies addon installed.

The free_gifts tag generates a list of products that have been assigned to the free gifts section on a product within the Maropost Commerce Cloud control panel. By default, we load this tag on the product page & the cart page. By assigning the products to the free gifts section within the control panel, this automatically changes the price to $0 when purchased with this product

For more information about the product templates, see the thumb list tag


Name Options Description
limit:'' Integer Limit the number of results
template:'' Name of the template without the .template.html Loads the template specified. If there is no value, it will load the default product template
ifempty:'' HTML & b@se tags If the free_gifts returns no results, it'll load this block instead
*header HTML & b@se tags Renders a single usable space above the body
*body HTML & b@se tags Runs an array for result
*footer HTML & b@se tags Renders a single usable space below the body

Data Tags (header/footer)

Data Tag Example Description
`[@total_gifts@]` 1 Number of free gifts

Data Tags (body)

Name Product Field Example Description
`[@acc_code@]`, `[@custom_label@]` Custom Label/Code 220/MDC Product identifier for eBay or accounting integration
`[@actual_height@]` Assembled Height 0.420 Assembled height in metres
`[@actual_length@]` Assembled Length 0.990 Assembled length in metres
`[@actual_width@]` Assembled Width 1.200 Assembled width in metres
`[@allow_oversell@]` Inventory Policy y **y** - Don't track inventory for this SKU, **n** - Track inventory for this SKU
`[@arrival_date@]` Date arrival 2018-12-31 Date at which the item is available. Displays date if in the future or nothing if the date is today or in the past (YYYY-MM-DD)
`[@artisit_author@]` Author/Artists John Green Name of the author or artist
`[@assemble_group_fullname@]` Full Name (Group) Accessories Kitting group Full Name
`[@availability_description@]` Availability Description New stock arriving in December Details of when the product will be available
`[@available_preorder_quantity@]` 79 The total of the **Qty on Hand** and **Preorder Qty**
`[@barcode@]` UPC/EAN 9300675031301 Product barcode
`[@base_unit@]` Base Unit of Measure kg The base unit of measure (ctn, ea, L, ml, cm, m, lb, g, kg)
`[@base_unit_qty@]` Base Unit Per Qty 2.0000 For display purposes only. Multiplies the actual qty by this qty. For example if base unit qty is 1.9 then a qty of 2 will display as 3.8
`[@brand@]` Brand Kingston Product brand
`[@count@]` 0 Unique number for each product displayed started at **0**
`[@cubic@]` Cubic 0.000250 The shipping width x length x height in metres
`[@date_created@]` 2016-05-20 Date the product was created (YYYY-MM-DD)
`[@display_template@]` Website Design Template custom Template used to display the product page. Blank is the default template. Not used for displaying the product thumbnail
`[@editable_bundle@]` Editable Kit n Is an edible kit? **y** - yes, **n** - no
`[@extra@]` Extra Options **Gift Message;*-TEXT_FIELD-;LENGTH=+50 Non-inventoried extras you offer the customer at the point of purchase. See [Product Import and Export Field Definitions](
`[@format@]` Format Soft Cover The format of the product
`[@has_child@]` 0 Has a child / variation product
`[@has_components@]` 0 Does this product have kit components. **0** - no, **1** - yes
`[@has_from_price@]` 1 Is the price of this child product is used on the thumbnail. Normally the cheapest but can be changed to the dearest. **1** - yes, **0** - no
`[@height@]` Shipping Height 0.230 Shipping height in metres
`[@inpromo@]` 1 Is the product on promotion. **0** - no, **1** - yes
`[@instock@]` 1 Is the product in stock. **0** - no, **1** - yes
`[@inventory_id@]` 22343 Unique number for this product
`[@is_kit@]` 0 Is this a kitted product. **0** - no, **1** - yes
`[@item_group@]` Group Bulk Only Group of products that require a minimum quantity. See **Settings & tools > All settings & tools > Products > Product Groups**
`[@itm_gp_id@]` 0 A unique id for kits/variations/parent items, typically for internal use
`[@itm_sortorder@]` Sort Order 1 10 Sort order (ascending order)
`[@itm_sortorder2@]` Sort Order 2 20 Sort order (ascending order)
`[@length@]` Shipping Length 0.220 Shipping length in metres
`[@limited_stock@]` 1 Displays true when the stock is lower then the global configuration for "low stock"
`[@manufacturer_model@]` Manufacturer model number A7DC/K The manufacturers model number of the product
`[@misc1@]`, `[@misc2@]`, etc *custom field name* The Fault in Our Stars Custom product fields
`[@model@]`, `[@name@]` Name Turtles All the Way Down Product name
`[@notax@]` Tax Free Product n Tax Free Product. **n** - does attract tax, **y** - does not attract tax
`[@preorder@]` 1 Is the product on pre-order. **0** - no, **1** - yes
`[@preorder_date@]` Date arrival 2018-07-31 Returns date if in the future otherwise blank
`[@preorder_quantity@]` Preorder Qty 80 Quantity of the product available to be purchased on pre-order
`[@price@]` Price 100.00 Product price based on the group the customer is assigned to. Does not take into account promo pricing
`[@product_subtype@]` Subtype Paperback The product subtype
`[@product_type@]` Type Book The product type
`[@promo_end@]` Promo End 2018-12-31 00:00:00 Promotion expiry date and time (YYYY-MM-DD HH:MM:SS)
`[@promo_price@]` Promo Price 90.00 Promotional price for the pricing group that the customer is assigned to
`[@promo_save@]` 10.00 Difference between the regular price and the promo price (percentage)
`[@promo_start@]` Promo Start 2018-12-31 23:59:59 Promotion start date and time (YYYY-MM-DD HH:MM:SS)
`[@retail@]` RRP 125.00 Recommend retail price
`[@save@]` 28.00 Percentage difference between the RRP and the selling price
`[@save_price@]` 35.00 Difference between the RRP and the selling price
`[@service_only@]` Service Item n Service product. Shipping methods and rates are ignored for service items
`[@sh_type_id@]` Shipping Category 1 ID number of the shipping category. Blank if **Service Item** is selected
`[@short_description@]` Short Description Turtles All the Way Down is a young adult novel written by American author John Green Short product description (up to 255 characters)
`[@single_price@]` 110.00/td> Price for one of this product
`[@sku@]` SKU 17MD-Black Product SKU
`[@start_date@]` Date arrival 2018-07-31 The date the next order from the supplier is due to arrive (YYYY-MM-DD)
`[@store_price@]` 110.00 Price for one of this product
`[@store_quantity@]` Qty On Hand 26 Available stock to sell. It is calculated by the total of all the warehouses minus the committed stock
`[@subtitle@]` Subtitle New book by John Green Normally appears below the name of the product on product pages
`[@thumb@]` Main /assets/thumb/17MD-Black.jpg Main product image thumbnail. If the child product has no image the parent image is returned
`[@thumb_1@]`, `[@thumb_2@]`, etc Alt 1, Alt 2, etc /assets/alt_1_thumb/17MD-Black.jpg Alt product images thumbnails
`[@unit@]` Selling Unit of Measure g The selling unit of measure. Can appear on invoices, etc
`[@url@]` Product URL Product web address
`[@weight@]` Shipping Weight 0.1000 Shipping weight on kilograms
`[@width@]` Shipping Width 0.210 Shipping width in metres

Was this article useful?

Be notified when this page is updated. Optional.