img_url フィルター（画像CDN URLを取得）

{
  "category": "media",
  "deprecated": true,
  "deprecation_reason": "The `img_url` filter has been replaced by [`image_url`](/docs/api/liquid/filters/image_url).",
  "description": "You can use the `img_url` filter on the following objects:\n\n- [`article`](/docs/api/liquid/objects/article)\n- [`collection`](/docs/api/liquid/objects/collection)\n- [`image`](/docs/api/liquid/objects/image)\n- [`line_item`](/docs/api/liquid/objects/line_item)\n- [`product`](/docs/api/liquid/objects/product)\n- [`variant`](/docs/api/liquid/objects/variant)",
  "parameters": [
    {
      "description": "The desired image size.",
      "name": "size",
      "positional": true,
      "required": false,
      "types": [
        "string"
      ]
    },
    {
      "description": "The part of the image to show if the specified image has an aspect ratio that differs from the original.",
      "name": "crop",
      "positional": false,
      "required": false,
      "types": [
        "string"
      ]
    },
    {
      "description": "The desired pixel density.",
      "name": "scale",
      "positional": false,
      "required": false,
      "types": [
        "number"
      ]
    },
    {
      "description": "The desired image format.",
      "name": "format",
      "positional": false,
      "required": false,
      "types": [
        "string"
      ]
    }
  ],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product | img_url }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "size",
      "description": "The size parameter allows you to specify the dimensions of the image up to a maximum of 5760 x 5760 px. You can specify only the width, only the height, or both, and you can also use the following named sizes:\n\n| Name | Dimensions |\n| --- | --- |\n| `pico` | `16x16 px` |\n| `icon` | `32x32 px` |\n| `thumb` | `50x50 px` |\n| `small` | `100x100 px` |\n| `compact` | `160x160 px` |\n| `medium` | `240x240 px` |\n| `large` |`480x480 px` |\n| `grande` | `600x600 px` |\n| `original`<br>`master` | `1024x1024 px` |\n",
      "syntax": "variable | img_url: string",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product | img_url: '480x' }}\n\n{{ product | img_url: 'x480' }}\n\n{{ product | img_url: '480x480' }}\n\n{{ product | img_url: 'large' }}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "crop",
      "description": "The `crop` parameter allows you to specify which part of the image to show if the specified dimensions result in an aspect ratio that differs from the original. You can use the following values:\n\n- `top`\n- `center`\n- `bottom`\n- `left`\n- `right`\n\nThe default value is `center`.\n",
      "syntax": "variable | img_url: crop: string",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product | img_url: crop: 'bottom' }}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "format",
      "description": "Specify which file format to use for the image. The valid formats are `pjpg` and `jpg`.\n\nIt's not practical to convert a lossy image format, like `jpg`, to a lossless image format, like `png`, so this filter does\nonly the following conversions:\n\n- `png` to `jpg`\n- `png` to `pjpg`\n- `jpg` to `pjpg`\n\n> Note:\n> Shopify automatically detects which image formats are supported by the client (e.g. `WebP`, `AVIF`, etc.) and\n> selects a file format for optimal quality and file size. When a format is specified, Shopify takes into account\n> the features (e.g. progressive, alpha channel) of the specified file format when making the final automatic format selection.\n> To learn more, visit https://cdn.shopify.com/.\n",
      "syntax": "variable | img_url: format: string",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product | img_url: format: 'pjpg' }}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "scale",
      "description": "Specify the pixel density of the image. The valid densities are 2 and 3.",
      "syntax": "variable | img_url: scale: number",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product | img_url: scale: 2 }}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Returns the [CDN URL](/themes/best-practices/performance/platform#shopify-cdn) for an image.",
  "syntax": "variable | img_url",
  "name": "img_url"
}