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 to
  • g:service → the name of the carrier
  • g: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.
  • 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:country sub-element value?
    • The value of the g:country sub-element must be a two-letter country code according to the ISO 3166-1 alpha-2 standard, for example CZ for the Czech Republic or SK for Slovakia.
    • Correct nesting is also important — g:country must be a sub-element inside the g:shipping block, 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 the g:shipping|g:country sub-element value using the Rewrite rule.
  • 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:country and g:price sub-elements are missing or empty.
  • Whether the g:price sub-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.

Was this article helpful?