What is ShippingRateSettings?
A ShippingRateSettings represents re-usable pieces of shipping information. It is designed for publication on an URL that may be referenced via the [[shippingSettingsLink]] property of an [[OfferShippingDetails]]. Several occurrences can be published, distinguished and matched (i.e. identified/referenced) by their different values for [[shippingLabel]].
Example JSON-LD skeleton
This minimal example only identifies a Schema.org type. It is not a complete entity, a Google rich-result test, or a claim about a real business.
{
"@context": "https://schema.org",
"@type": "ShippingRateSettings"
}
Full parent hierarchy
Each chain starts at a root type. Multiple paths are shown when Schema.org defines more than one parent. For very complex types, up to 256 paths are displayed; consult the official definition for the full graph.
- Thing → Intangible → StructuredValue → ShippingRateSettings
Direct parents: StructuredValue
Child types (0)
No entries listed in the available snapshot.
Properties that accept ShippingRateSettings values (1)
| Property | On types | Description |
|---|---|---|
| shippingRate | OfferShippingDetails or ShippingConditions or ShippingRateSettings | The shipping rate is the cost of shipping to the specified destination. Typically, the maxValue and currency values (of the [[MonetaryAmount]]) are most appropriate. |
Properties usable on ShippingRateSettings (22)
This list includes properties whose domainIncludes names ShippingRateSettings or one of its ancestors. DomainIncludes is advisory; it is not an exhaustive set of permitted properties.
| Property | Expected value types | Description |
|---|---|---|
| additionalType | Text, URL | An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org <a href="https://schema.org/docs/styleguide.html">style guide</a>. |
| alternateName | Text | An alias for the item. |
| description | Text, TextObject | A description of the item. |
| disambiguatingDescription | Text | A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation. |
| doesNotShip | Boolean | Indicates when shipping to a particular [[shippingDestination]] is not available. |
| freeShippingThreshold | DeliveryChargeSpecification, MonetaryAmount | A monetary value above (or at) which the shipping rate becomes free. Intended to be used via an [[OfferShippingDetails]] with [[shippingSettingsLink]] matching this [[ShippingRateSettings]]. |
| identifier | PropertyValue, Text, URL | The identifier property represents any kind of identifier for any kind of [[Thing]], such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See [background notes](/docs/datamodel.html#identifierBg) for more details. |
| image | ImageObject, URL | An image of the item. This can be a [[URL]] or a fully described [[ImageObject]]. |
| isUnlabelledFallback | Boolean | This can be marked 'true' to indicate that some published [[DeliveryTimeSettings]] or [[ShippingRateSettings]] are intended to apply to all [[OfferShippingDetails]] published by the same merchant, when referenced by a [[shippingSettingsLink]] in those settings. It is not meaningful to use a 'true' value for this property alongside a transitTimeLabel (for [[DeliveryTimeSettings]]) or shippingLabel (for [[ShippingRateSettings]]), since this property is for use with unlabelled settings. |
| mainEntityOfPage | CreativeWork, URL | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details. |
| minimumOrderValue | MonetaryAmount, Number, PriceSpecification | The minimum order value required for this shipping rate to apply. |
| name | Text | The name of the item. |
| orderPercentage | Number | Value representing the fraction of the value of the order that is charged as shipping cost. Example: 0.10 would mean shipping rate is 10% of the total order value. |
| owner | Organization, Person | A person or organization who owns this Thing. |
| potentialAction | Action | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role. |
| sameAs | URL | URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website. |
| shippingDestination | DefinedRegion | indicates (possibly multiple) shipping destinations. These can be defined in several ways, e.g. postalCode ranges. |
| shippingLabel | Text | Label to match an [[OfferShippingDetails]] with a [[ShippingRateSettings]] (within the context of a [[shippingSettingsLink]] cross-reference). |
| shippingRate | MonetaryAmount, ShippingRateSettings | The shipping rate is the cost of shipping to the specified destination. Typically, the maxValue and currency values (of the [[MonetaryAmount]]) are most appropriate. |
| subjectOf | CreativeWork, Event | A CreativeWork or Event about this Thing. |
| url | URL | URL of the item. |
| weightPercentage | Number | Value representing the fraction of the weight that is used to compute the shipping price. Example: 0.10 and a shipping weight of 15kg would add $1.5 to the order price, where the $ is the currency of the order. |
Schema.org vs Google
This type's presence in Schema.org is not a Google feature approval. Check our dated Google status snapshot and Google's official Rich Results Test separately.