🤖 Sync Liquid Docs Schema

Author: dev-bot-shopify[bot]

data/filters.json

@@ -4965,6 +4965,46 @@
     "syntax": "number | pluralize: string, string",
     "name": "pluralize"
   },
+  {
+    "category": "format",
+    "deprecated": false,
+    "deprecation_reason": "",
+    "description": "",
+    "parameters": [],
+    "return_type": [
+      {
+        "type": "string",
+        "name": "",
+        "description": "",
+        "array_value": ""
+      }
+    ],
+    "examples": [
+      {
+        "name": "",
+        "description": "",
+        "syntax": "",
+        "path": "/products/blue-mountain-flower",
+        "raw_liquid": "{%- assign variant = product.variants.first -%}\n\n{{ variant.unit_price | unit_price_with_measurement: variant.unit_price_measurement }}",
+        "parameter": false,
+        "display_type": "text",
+        "show_data_tab": true
+      },
+      {
+        "name": "Formatted unit price",
+        "description": "You can specify a formatted unit price using one of the [money filters](/docs/api/liquid/filters/payment_button#money-filters).",
+        "syntax": "string | unit_price_with_measurement: unit_price_measurement",
+        "path": "/products/blue-mountain-flower",
+        "raw_liquid": "{%- assign variant = product.variants.first -%}\n\n{{ variant.unit_price | money_with_currency | unit_price_with_measurement: variant.unit_price_measurement }}",
+        "parameter": true,
+        "display_type": "text",
+        "show_data_tab": true
+      }
+    ],
+    "summary": "Formats a given unit price and measurement based on the store's [**HTML without currency** setting](https://help.shopify.com/manual/payments/currency-formatting).",
+    "syntax": "number | unit_price_with_measurement: unit_price_measurement",
+    "name": "unit_price_with_measurement"
+  },
   {
     "category": "media",
     "deprecated": true,

data/objects.json

@@ -7264,7 +7264,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "> Note:\n> Unit prices are available only to stores located in Germany or France.\n\nTo learn about how to display unit prices in your theme, refer to [Unit pricing](/themes/pricing-payments/unit-pricing).",
+        "description": "> Note:\n> Unit prices are available only to stores located in the European Union or Switzerland.\n\nTo learn about how to display unit prices in your theme, refer to [Unit pricing](/themes/pricing-payments/unit-pricing).\n\n> Tip:\n> Use the [`unit_price_with_measurement` filter](/docs/api/liquid/filters/unit_price_with_measurement) with the\n> `line_item.unit_price` property and this property to output a formatted unit price with measurement.",
         "examples": [],
         "return_type": [
           {
@@ -7280,7 +7280,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "The price reflects any discounts that are applied to the line item. The value is output in the customer's local\n(presentment) currency.\n\nFor currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.\n\n> Note:\n> Unit prices are available only to stores located in Germany and France.\n\nTo learn about how to display unit prices in your theme, refer to [Unit pricing](/themes/pricing-payments/unit-pricing).\n\n> Tip:\n> Use [money filters](/docs/api/liquid/filters/money-filters) to output a formatted price.",
+        "description": "The price reflects any discounts that are applied to the line item. The value is output in the customer's local\n(presentment) currency.\n\nFor currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.\n\n> Note:\n> Unit prices are available only to stores located in the European Union or Switzerland.\n\n> Tip:\n> Use the [`unit_price_with_measurement` filter](/docs/api/liquid/filters/unit_price_with_measurement) with this\n> property and the `line_item.unit_price_measurement` property to output a formatted unit price with measurement.\n\nTo learn about how to display unit prices in your theme, refer to [Unit pricing](/themes/pricing-payments/unit-pricing).",
         "examples": [],
         "return_type": [
           {
@@ -7290,7 +7290,7 @@
             "array_value": ""
           }
         ],
-        "summary": "The [unit price](https://help.shopify.com/manual/intro-to-shopify/initial-setup/sell-in-france/price-per-unit#add-unit-prices-to-your-product)\n of the line item in the currency's subunit.",
+        "summary": "The [unit price](https://help.shopify.com/manual/products/details/product-pricing/unit-pricing#add-unit-prices-to-your-product)\n of the line item in the currency's subunit.",
         "name": "unit_price"
       },
       {
@@ -10684,7 +10684,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "",
+        "description": "Limited to 250.",
         "examples": [],
         "return_type": [
           {
@@ -10700,7 +10700,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "For example, if you show 5 items per page and are on page 3, then the value of `paginate.current_offset` is 10.",
+        "description": "For example, if you show 5 items per page and are on page 3, then the value of `paginate.current_offset` is 10.\n\nLimited to 24,999 see [Pagination Limits](/themes/best-practices/performance/platform#pagination-limits) for more information.",
         "examples": [],
         "return_type": [
           {
@@ -10716,7 +10716,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "",
+        "description": "Limited to 25,000 see [Pagination Limits](/themes/best-practices/performance/platform#pagination-limits) for more information.",
         "examples": [],
         "return_type": [
           {
@@ -10732,7 +10732,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "For example, if you paginate a collection of 120 products, then the value of `paginate.items` is 120.",
+        "description": "For example, if you paginate a collection of 120 products, then the value of `paginate.items` is 120.\n\nLimited to 25,000 see [Pagination Limits](/themes/best-practices/performance/platform#pagination-limits) for more information.",
         "examples": [],
         "return_type": [
           {
@@ -10796,7 +10796,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "",
+        "description": "Limited to 25,000 see [Pagination Limits](/themes/best-practices/performance/platform#pagination-limits) for more information.",
         "examples": [],
         "return_type": [
           {
@@ -12543,7 +12543,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "> Note:\n> Unit prices are available only to stores located in Germany and France.",
+        "description": "> Note:\n> Unit prices are available only to stores located in the European Union or Switzerland.\n\nTo learn about how to display unit prices in your theme, refer to [Unit pricing](/themes/pricing-payments/unit-pricing).\n\n> Tip:\n> Use the [`unit_price_with_measurement` filter](/docs/api/liquid/filters/unit_price_with_measurement) with the\n> `variant.unit_price` property and this property to output a formatted unit price with measurement.",
         "examples": [],
         "return_type": [
           {
@@ -12559,7 +12559,7 @@
       {
         "deprecated": false,
         "deprecation_reason": "",
-        "description": "The price reflects any discounts that are applied to the line item. The value is output in the customer's local\n(presentment) currency.\n\nFor currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.\n\n> Note:\n> Unit prices are available only to stores located in Germany and France.\n\n> Tip:\n> Use [money filters](/docs/api/liquid/filters/money-filters) to output a formatted price.",
+        "description": "The price reflects any discounts that are applied to the line item. The value is output in the customer's local\n(presentment) currency.\n\nFor currencies without subunits, such as JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen is output as 100000.\n\n> Note:\n> Unit prices are available only to stores located in the European Union or Switzerland.\n\n> Tip:\n> Use the [`unit_price_with_measurement` filter](/docs/api/liquid/filters/unit_price_with_measurement) with this\n> property and the `variant.unit_price_measurement` property to output a formatted unit price with measurement.\n\nTo learn about how to display unit prices in your theme, refer to [Unit pricing](/themes/pricing-payments/unit-pricing).",
         "examples": [],
         "return_type": [
           {
@@ -12569,7 +12569,7 @@
             "array_value": ""
           }
         ],
-        "summary": "The [unit price](https://help.shopify.com/manual/intro-to-shopify/initial-setup/sell-in-france/price-per-unit#add-unit-prices-to-your-product)\nof the variant in the currency's subunit.",
+        "summary": "The [unit price](https://help.shopify.com/manual/products/details/product-pricing/unit-pricing#add-unit-prices-to-your-product)\nof the variant in the currency's subunit.",
         "name": "unit_price"
       },
       {
@@ -16901,7 +16901,7 @@
     },
     "deprecated": false,
     "deprecation_reason": "",
-    "description": "> Note:\n> Unit prices are available only to stores located in Germany and France.",
+    "description": "> Note:\n> Unit prices are available only to stores located in the European Union or Switzerland.",
     "properties": [
       {
         "deprecated": false,
@@ -16923,7 +16923,19 @@
           },
           {
             "type": "string",
-            "name": "dimension",
+            "name": "length",
+            "description": "",
+            "array_value": ""
+          },
+          {
+            "type": "string",
+            "name": "area",
+            "description": "",
+            "array_value": ""
+          },
+          {
+            "type": "string",
+            "name": "count",
             "description": "",
             "array_value": ""
           }
@@ -16996,7 +17008,7 @@
         "name": "reference_unit"
       }
     ],
-    "summary": "Information about how units of a product variant are measured. It's used to calculate\n[unit prices](https://help.shopify.com/manual/intro-to-shopify/initial-setup/sell-in-france/price-per-unit#add-unit-prices-to-your-product).",
+    "summary": "Information about how units of a product variant are measured. It's used to calculate\n[unit prices](https://help.shopify.com/manual/products/details/product-pricing/unit-pricing#add-unit-prices-to-your-product).",
     "name": "unit_price_measurement",
     "examples": [],
     "json_data": {

data/tags.json

@@ -1008,15 +1008,15 @@
     ],
     "summary": "Splits an array's items across multiple pages.",
     "name": "paginate",
-    "syntax": "{% paginate array by page_size %}\n  {% for item in array %}\n    forloop_content\n  {% endfor %}\n{% endpaginate %}",
+    "syntax": "{% paginate array by page_size %}\n  {% for item in array %}\n    forloop_content\n  {% endfor %}\n{% endpaginate %}\n\nThe `paginate` tag allows the user to paginate to the 25,000'nth item in the array an no further. To reach items further in\nthe array the array should be filtered further before paginating. See\n[Pagination Limits](/themes/best-practices/performance/platform#pagination-limits) for more information.",
     "syntax_keywords": [
       {
         "keyword": "array",
         "description": "The array to be looped over."
       },
       {
         "keyword": "page_size",
-        "description": "The number of array items to include per page, between 1 and 50."
+        "description": "The number of array items to include per page, between 1 and 250."
       },
       {
         "keyword": "item",
@@ -1050,10 +1050,10 @@
       },
       {
         "name": "Limit data fetching",
-        "description": "Limiting the number of iterations through an array with the `paginate` tag can be more performant than using the [`limit` parameter](/docs/api/liquid/tags/for#for-limit) of the `for` tag. The `limit` parameter sets the number of iterations executed, but not the amount of information fetched server-side.\n\nFor example, referencing `collection.products` will fetch information up to the first 50 products, regardless of the forloop's `limit` parameter.  Use `paginate` and set a `page_size` to limit the amount of data fetched, and opt not to display any pagination controls.\n",
+        "description": "The [`limit` parameter](/docs/api/liquid/tags/for#for-limit) of the `for` tag controls the number of iterations, but not the amount of information fetched. Using the `paginate` tag with a matching `page_size` can reduce the data queried, leading to faster server response times. \n\nFor example, referencing `collection.products` will fetch up to 50 products by default, regardless of the forloop's `limit` parameter. Use `paginate` and set a `page_size` to limit the amount of data fetched, and opt not to display any pagination controls.\n\nMore data than requested in a specific section may be returned. Because of this, make sure to include both `paginate` and `limit` when using this technique.\n",
         "syntax": "",
         "path": "/collections/all",
-        "raw_liquid": "{% paginate collection.products by 4 %}\n  {% for product in collection.products -%}\n    {{ product.title }}\n  {%- endfor %}\n{% endpaginate -%}\n\n<!-- Less performant method -->\n{% for product in collection.products limit: 4 -%}\n  {{ product.title }}\n{%- endfor -%}",
+        "raw_liquid": "{% paginate collection.products by 4 %}\n  {% for product in collection.products limit: 4 -%}\n    {{ product.title }}\n  {%- endfor %}\n{% endpaginate -%}\n\n<!-- Less performant method -->\n{% for product in collection.products limit: 4 -%}\n  {{ product.title }}\n{%- endfor -%}",
         "parameter": false,
         "display_type": "text",
         "show_data_tab": true