商品画像の一括アップロード

対応ファイル形式は、JPEG（.jpg）のみになります。 JPEG（.JPG）・JPEG（.jpeg）・PNG・GIFなどはご利用できません。
使用可能な商品画像ファイルの最大容量は500KBまでです。

商品情報が登録されている場合、以下の手順で商品画像を登録できます。
登録されていない商品の画像は登録できません。

1. FTPサーバの/upload/image/ディレクトリに商品画像を配置します。
2. 商品画像をZIP形式のファイルにして配置してください。
   ZIPファイル容量は512MBまでです。
   ZIPファイル内にフォルダなどを含めず、画像のみをZIPファイルに圧縮してください。
3. ZIPファイル名はproduct_ + 任意の文字列 + .zip（「product」の後の文字は半角アンダーバーです）としてください。任意の文字列には半角英数、「_（アンダーバー）」、「-（ハイフン）」、「.（ピリオド）」が使用できます。「product.zip」も可能です。
4. アップロードできる7サイズ（オリジナル画像 / XXL / XL / L / M / S / XS）は、画像ファイル名が決まっています。画像ファイル名をご覧ください。

商品画像について詳しくは商品画像設定（コマースクリエイター）をご覧ください。

アップロード作業前に、アップロードにあたっての注意事項をご確認ください。

アップロード画像とリサイズ処理について

FTPサーバの指定ディレクトリへZIPファイルを配置すれば、自動的に取り込み処理が行われます。（定期的な自動処理となります。）
処理状況は運用＞商品管理＞商品データ一括登録履歴一覧に表示されます。

必ず、オリジナル画像をアップロードしてください。

オリジナル画像は、設定＞商品・商品グループ＞商品ページ設定-商品画像幅設定-商品画像幅設定構築＞ページ設定＞商品ページ設定-商品 画像幅設定-画像幅または、該当商品の運用＞商品管理＞商品画像設定（コマースクリエイター）-商品 画像幅設定-画像幅の画像幅サイズにあわせて、リサイズ処理されます。

画像サイズがリサイズしたいサイズより小さい場合は、リサイズ処理せずコピーとなります。

オリジナル画像のみをZIPファイルに保存した場合

オリジナル画像のみアップロードすると、オリジナル画像の画像幅を自動的にリサイズし、さらに各サイズ画像（XXL / XL / L / M / S / XS）をリサイズ処理にて自動生成します。

オリジナル画像と各サイズ画像をZIPファイルに同梱した場合

各サイズ画像をZIPファイルに同梱すると、リサイズ処理をせず、コピーします。

オリジナル画像と一部のサイズ画像をZIPファイルに同梱した場合

オリジナル画像の画像幅を自動的にリサイズ、同梱されたサイズ画像はそのままコピーします。
同梱されていないサイズ画像については、リサイズ処理にて自動生成します。

商品グループ画像の一括アップロード

対応ファイル形式は、JPEG（.jpg）のみになります。 JPEG（.JPG）・JPEG（.jpeg）・PNG・GIFなどはご利用できません。
使用可能な商品画像ファイルの最大容量は500KBまでです。

商品グループ情報が登録されている場合、以下の手順で商品画像を登録できます。
登録されていない商品グループの画像は登録できません。

1. FTPサーバの/upload/image/ディレクトリに商品グループ画像を配置します。
2. 商品グループ画像をZIP形式のファイルにして配置してください。
   ZIPファイル容量は512MBまでです。
   ZIPファイル内にフォルダなどを含めず、画像のみをZIPファイルに圧縮してください。
3. ZIPファイル名はcategory_ + 任意の文字列 + .zip（「category」の後の文字は半角アンダーバーです）としてください。任意の文字列には半角英数、「_（アンダーバー）」、「-（ハイフン）」、「.（ピリオド）」が使用できます。「category.zip」も可能です。
4. 設定＞商品・商品グループ＞商品一覧ページ設定-商品グループ画像幅設定-商品グループ画像幅設定構築＞ページ設定＞商品ページ設定-商品グループ 画像幅設定-商品グループ画像が「リサイズする（あり）」、かつオリジナル画像が商品画像幅設定の「画像サイズと初期設定」商品ページ設定の「商品画像各サイズの使用」の「商品一覧」のサイズ指定より大きい場合は、画像をリサイズ処理にて自動生成します。画像サイズがリサイズしたいサイズより小さい場合は、リサイズせずコピーとなります。
5. 取り込み処理が終了すると、商品グループ画像として掲載されます。商品グループ画像にALTテキストを登録するには、商品グループ一括登録（コマースクリエイター）（CSVファイル）をアップロードします。詳しくは運用＞商品管理＞商品データ一括登録をご覧ください。

アップロード作業前に、アップロードにあたっての注意事項をご確認ください。

商品画像・商品グループ画像の取得

バックアップなどの用途で、登録されている商品画像・商品グループ画像を取得できます。
商品画像はFTPサーバの/itembox/product/、商品グループ画像は/itembox/category/から取得できます。

FTPサーバのディレクトリ（商品画像・商品グループ画像）

商品画像・商品グループ画像のアップロードディレクトリとURLは以下となります。

商品IDは商品情報登録時にシステムから自動発番されるIDです。商品グループIDは商品情報登録時にシステムから自動発番されるIDです。

特定の商品画像のみを上書きアップロードする場合

商品画像がアップロードされている/product/ディレクトリに、特定の商品画像のみをアップロードしても上書きできません。

上書きしたい（差し替えたい）サイズの画像を、オリジナル画像と共に一つのZIPファイルにまとめ、/upload/image/にアップロードしてください。

ZIPファイル内にフォルダなどを含めず、画像のみをZIPファイルに圧縮してください。

対応ファイル形式は、JPEG（.jpg）、GIF（.gif）、PNG（.png）、SVG（.svg）になります。
使用可能な商品画像ファイルの最大容量は1ファイルあたり30MBまでです。

コマースクリエイター＞アイテムに登録するファイルを、FTPサーバーからアップロード/ダウンロードできます。

• FTPサーバの/itembox/item/ディレクトリにファイルを配置します。「/itembox/item/」ディレクトリは、コマースクリエイター＞アイテムと同期しています。
• /itembox/item/ディレクトリ配下に直接、またはディレクトリを作成し、その配下にファイルをアップロードできます。
• 初期配置されているディレクトリ/itembox/item/s/配下には、htmlファイルおよびJavaScriptファイルのみ配置できます。
  htmlファイル・JavaScriptファイル以外をアップロードすると正しく読み込めなくなる場合があります。その他の形式のファイルは、パスに「/s」以外を指定してください。
• アップロードしたファイルは、コマースクリエイター＞アイテムに表示されます。
  アイテム名は「（/itembox/item/以下の）ファイルパス」、管理タグは付きません。
• アップロードしたファイルは、https://{店舗key}.itembox.design/item/ファイルパス（アイテムのパス）のURLで表示できます。
  （例）「/item/sample.png」のURLは、「https://{店舗key}.itembox.design/item/sample.png」となります。
• 同じディレクトリ、同じファイル名でアップロードすれば、上書きは可能です。
  アイテムにアップロードした画像はキャッシュ機構により一時的に保存されていますので、アイテムをURLにて直接指定して表示した場合、上書きしても、すぐには更新されません。（1分程度）
  パターンパーツ（カルーセル・コラム）の画像表示機能を使用している場合や、フリーパーツやフリーページ本文にて「アイテム置換文字」を使用して表示している場合は、すぐに更新されます。
• FTPサーバから削除すると、コマースクリエイター＞アイテムからも削除されます。
• ZIPファイルでの一括アップロードはできません。
• /itembox/item/s/、/itembox/item/top/は用途が固定された既定のディレクトリ名です。削除しないでください。
• 管理タグはコマースクリエイター＞アイテムから設定できます。一括で設定する方法はありません。
• ディレクトリ名・ファイル名には、半角英数字と記号「.」「_」「-」「/」を利用できます。

FTPサーバのディレクトリ（アイテム）

初期は下記のようなディレクトリ構成となっています。