Element g:shipping#
Basic information#
The g:shipping element specifies the shipping cost for the product and optionally the delivery speed for orders.
g:shipping itself is just a wrapper for sub-elements:
g:country→ the country the product can be delivered tog:service→ the name of the carrierg:price→ the shipping cost for that carrier
The g:shipping block appears in the feed once for each available delivery method.
The g:country and g:price sub-elements are required.
The price in the g:price sub-element must include the currency in addition to the amount, for example: 150 CZK. For decimal values, use a period as the separator, rounded to a maximum of two decimal places, for example: 99.65 CZK.
Elements related to g:shipping that can also be used in the feed:
- g:min_handling_time — minimum handling time, i.e. the minimum number of days from order placement to handover to the carrier
- g:max_handling_time — maximum handling time, i.e. the maximum number of days from order placement to handover to the carrier
- g:min_transit_time — minimum transit time, i.e. the minimum number of days from handover to the carrier to delivery to the customer
- g:max_transit_time — maximum transit time, i.e. the maximum number of days from handover to the carrier to delivery to the customer
Frequently asked questions#
- How do I set shipping costs? How do I add another carrier?
- Use the Set shipping rates rule.
- How do I set free shipping above a certain order amount?
- First, on the Products page, create a query of products that should have free shipping. Then create a Set shipping rates rule applied to this query, and set the price fields to zero (
0) for each carrier in the rule.
- First, on the Products page, create a query of products that should have free shipping. Then create a Set shipping rates rule applied to this query, and set the price fields to zero (
- How do I remove a carrier from the feed?
- Use the Set shipping rates rule, and for the carrier you want to remove, leave the price fields empty. The rule will then remove that carrier.
- What is the correct format for the
g:countrysub-element value?- The value of the
g:countrysub-element must be a two-letter country code according to the ISO 3166-1 alpha-2 standard, for exampleCZfor the Czech Republic orSKfor Slovakia. - Correct nesting is also important —
g:countrymust be a sub-element inside theg:shippingblock, not a standalone element at the top level of the feed. The Set shipping rates rule creates this sub-element automatically and populates it with the country based on the selected feed format. If you need a different country (for example, the format is CZ but you want to deliver to SK), overwrite theg:shipping|g:countrysub-element value using the Rewrite rule.
- The value of the
- How do I set shipping costs based on product weight?
- First, on the Products page, create queries that segment the feed by weight — for example, queries for weight ranges 0–5 kg, 5–10 kg, 10–15 kg, and so on. Then create a separate Set shipping rates rule for each query and set specific amounts for each carrier in those rules for the given weight range.
What Mergado Audit checks for the g:shipping element#
- Whether the required
g:countryandg:pricesub-elements are missing or empty. - Whether the
g:pricesub-element contains an invalid value — it must include both an amount (a positive number) and a currency (in international format, e.g. CZK).
If you need help, contact our technical support.