📘 公式リファレンス🔧 リファレンス/フィルター初級

url_encode フィルター（URL安全な文字列に変換）

文字列に含まれる URL に使えない文字をパーセントエンコード形式に変換する。スペースは `+` に変換される。

用途

ユーザー入力やメタフィールドの値を URL パラメータとして埋め込むときに使用。メールアドレスや日本語を含む検索キーワードを URL 安全な形式に整形する。

設置場所

Liquid テンプレート内で `{{ value | url_encode }}` の形で使用。例: `<a href="/search?q={{ search.terms | url_encode }}">検索</a>` のように検索フォームのクエリパラメータに指定。

注意点

スペースはパーセント符号（%20）ではなく `+` に変換される点に注意。URL クエリストリング用途ではこの仕様で問題ないが、フラグメント（#後）やパス要素に埋め込む場合は別途処理が必要な場合もある。日本語を含む文字列は正しくエンコードされるため、国際化対応ストアでも安心して使える。

タグ:filterurlencodingstringparameter

仕様

30 行 / json

{
  "category": "string",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "&gt; Note:\n&gt; Spaces are converted to a `+` character, instead of a percent-encoded character.",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{{ 'test@test.com' | url_encode }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Converts any URL-unsafe characters in a string to the\n[percent-encoded](https://developer.mozilla.org/en-US/docs/Glossary/percent-encoding) equivalent.",
  "syntax": "string | url_encode",
  "name": "url_encode"
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/filters.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

このコードは Shopify 著作の MIT ライセンスソースです。原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

url_encode フィルター（URL安全な文字列に変換）

仕様

出典・ライセンス

関連項目

avatar フィルター（顧客アバター画像HTML生成）

default_errors フィルター（フォーム送信エラーを日本語化）

date フィルター（日付を指定形式でフォーマット）

payment_terms フィルター（Shop Pay分割払いバナーを生成）

abs フィルター（数値の絶対値を取得）

append フィルター（文字列の末尾に追加）