設定画面:商品管理 / 商品属性の拡張
原材料名・アレルゲン・素材・保証期間など、商品ごとに管理したい情報を「属性」として作成し、商品ページに表形式で表示できる機能です。
入力した値は、商品一覧の絞り込み・商品CSV・商品取得APIでも利用できます。
| 商品ページへの表示に対応しているのは、ノーコードデザイン/クリエイターモードをご利用のショップのみです。 旧PCデザイン・旧スマートフォンデザインをご利用のショップでは、商品ページに表示されません。 属性が表示されるのは商品詳細ページのみです。商品一覧・カテゴリ・検索結果・トップページなどの商品表示には表示されません。 属性の作成・値の入力・商品一覧での絞り込み・商品CSV・商品取得APIは、デザインに関わらずご利用いただけます。 |
商品属性の拡張とは
この機能は「属性」と「商品属性グループ」の2つで構成されています。
| 名称 | 内容 | 例 |
|---|---|---|
| 属性 | 商品に持たせる項目そのものです。属性名・説明文・入力形式(テキスト/数値/選択式/日付)を設定します。 | 原材料名、アレルゲン、素材、保証期間 |
| 商品属性グループ | 属性をまとめたものです。商品には商品属性グループを設定します。グループ名は購入者には表示されません。 | 食品表示、ギフト |
設定から商品ページに表示されるまでの流れは次のとおりです。
- 商品属性グループを作成し、グループに属性を追加します。
- 商品編集画面で、商品に商品属性グループを設定します。
- 表示された入力欄に値を入力して保存すると、商品ページに表示されます。
| 属性を作成しただけでは、商品編集画面に入力欄は表示されません。 属性を商品属性グループに追加し、そのグループを商品に設定してはじめて入力欄が表示されます。 1つの属性は複数のグループに追加でき、1つの商品にも複数のグループを設定できます。複数のグループに同じ属性が含まれている場合でも、入力欄は1つにまとめて表示されます。 |
商品属性グループを作成する
- 「商品管理 / 商品属性の拡張」を開きます。
はじめて開いたときは、始め方の説明が自動で表示されます。閉じたあとは、画面右上の「⋮」→「始め方を見る」からいつでも確認できます。 - 商品属性グループの新規登録画面を開きます。
- 商品属性グループ名を入力します(30文字まで)。同じ名前のグループは作成できません。
- 画面の属性一覧から、グループに含める属性にチェックを付けます。
一覧にない属性は「属性を追加」から作成できます。詳しくは属性を追加するをご確認ください。 - 内容を保存します。
| 属性を1つもチェックしていない状態では、グループを登録できません。 属性の追加・編集・削除は、すべて商品属性グループの編集画面で行います(属性だけの一覧画面はありません)。 |
商品属性グループ一覧の見方
| 項目 | 内容 |
|---|---|
| 商品属性グループ名 | ショップで設定したグループ名です。クリックすると編集画面を開きます。 |
| 商品属性グループコード | 「MG00001」形式のコードです。商品CSVでグループを指定する際に使用します。コピーアイコンからコピーできます。 |
| 含まれる属性 | グループに含まれる属性のうち先頭3件と、残りの件数(ほか◯件)を表示します。 |
| 使っている商品 | このグループを設定している商品数です。 |
| 作成日 | グループの作成日です。初期表示は作成日の新しい順です。 |
属性を追加する
属性の追加方法は、makeshopが用意した属性から選ぶ方法と、新しく作成する方法の2通りです。
makeshopが用意した属性から選ぶ
商品属性グループの編集画面の属性一覧に、makeshopが用意した属性があらかじめ表示されています。グループに含めたい属性にチェックを付けるだけで利用できます。
「主な利用ジャンル」列で商材の種類を確認でき、チップで絞り込むこともできます。
用意されている属性のジャンルは次のとおりです。
- 共通(ブランド・型番・JANコードなど)
- 食品・飲料・健康食品
- ファッション
- 家電・PC
- 生活・インテリア・文具
- ビューティ・コスメ
- スポーツ・アウトドア
makeshopが用意した属性の一覧は次のとおりです。識別子と入力形式は固定です。
| 名称 | 識別子(キー) | 入力形式 | 備考 |
|---|---|---|---|
| アレルゲン | ms_allergens | 選択式(複数選択) | |
| アレルゲンの注意事項 | ms_allergen_note | テキスト | |
| 原材料名 | ms_ingredients | テキスト | |
| 添加物 | ms_additives | テキスト | |
| 栄養成分 | ms_nutrition_facts | テキスト | |
| 内容量 | ms_volume | テキスト | |
| 保存方法 | ms_storage_method | テキスト | |
| 賞味・消費期限 | ms_expiry | テキスト | |
| 原料原産地 | ms_origin | テキスト | |
| 製造者名 | ms_manufacturer | テキスト | |
| 販売者・輸入者名 | ms_seller_importer | テキスト | |
| ブランド | ms_brand | テキスト | |
| 型番 | ms_model_number | テキスト | |
| JANコード | ms_jan | テキスト | |
| ISBNコード | ms_isbn | テキスト | |
| 原産地 | ms_country_of_origin | テキスト | |
| 色 | ms_color | テキスト | |
| サイズ | ms_size | テキスト | |
| 素材 | ms_material | テキスト | |
| 柄 | ms_pattern | テキスト | |
| 性別 | ms_gender | 選択式 | |
| 年齢層 | ms_age_group | 選択式 | |
| 重量 | ms_weight | 数値 | 数値のみの入力です。 単位は「属性を編集」より設定します。 |
| 寸法 | ms_dimensions | テキスト | |
| お手入れ方法 | ms_care | テキスト | |
| 保証期間 | ms_warranty | テキスト | |
| 省エネ性能 | ms_energy | テキスト | |
| モデル年 | ms_model_year | テキスト | |
| 耐荷重 | ms_load_capacity | テキスト | |
| 付属品 | ms_accessories | テキスト | |
| 全成分 | ms_full_ingredients | テキスト | |
| 開封後使用期限 | ms_open_expiry | テキスト | |
| 対象年齢 | ms_target_age | テキスト |
| 「原料原産地(ms_origin)」は食品の原料の原産地、「原産地(ms_country_of_origin)」は商品そのものの原産地です。別の項目としてご利用ください。 名称はショップで変更できます(makeshopが用意した属性で変更できる項目)。名称を変更しても識別子は変わりません。 |
新しく属性を作成する
用意された属性にない項目は、商品属性グループの編集画面の「属性を追加」から作成します。
- 属性名:
属性の名称を入力します(100文字まで)。商品ページや商品CSVの列名に使用されます。同じ名前の属性は作成できません。 - 説明文:
属性の説明を入力します(500文字まで)。 - 入力形式:
テキスト/数値/選択式/日付から選択します。作成後は変更できません。
テキストは1,000文字まで入力でき、改行はそのまま商品ページに反映されます。
数値の場合は単位表記(20文字まで)を設定できます。商品ページでは末尾の0を省いて表示されます(例:1.50 → 1.5)。
日付は、商品ページで「2026/12/31」の形式で表示されます。 - 選択肢:
入力形式が選択式の場合に設定します。1属性あたり30件まで、選択肢名は30文字までです。「|」(半角パイプ)は使用できません。 - 識別子(キー):
クリエイターモードや商品取得APIで属性を指定するための名前です。入力欄の左に「ms_」が固定で付いており、続けて半角英数字とアンダースコアで入力します(ms_を含めて64文字まで)。
未入力の場合は「MS00001」形式の番号が自動で発行されます。作成後は変更できません。属性名を変更しても識別子は変わりません。詳しくは識別子の形式と確認方法をご確認ください。 - 商品ページへの表示:
ONにすると、値が入力されている場合に商品ページに表示されます。OFFの場合も、商品CSV・商品取得APIでは利用できます。 - 値が未入力のときに表示するテキスト:
値が入力されていない商品で、値の位置に表示するテキストを設定します(30文字まで)。未設定の場合、値が未入力の属性は商品ページに表示されません。
| 入力形式は、作成後に変更できません。変更したい場合は、属性を削除して作り直してください。属性を削除すると、その属性に入力されている全商品の値も削除されます。 「はい/いいえ」のような項目を作成したい場合は、入力形式を選択式にし、選択肢に「はい」「いいえ」を登録してください(「対応/非対応」なども同様です)。 |
makeshopが用意した属性で変更できる項目
属性一覧で鍵アイコンが付いている属性は、makeshopが用意した属性です。変更できる項目は次のとおりです。
| 項目 | 変更 | 補足 |
|---|---|---|
| 属性名 | できる | 「賞味・消費期限」を「賞味期限」にするなど、ショップに合わせて変更できます。 |
| 説明文 | できる | |
| 入力形式 | できない | |
| 選択肢 | できない | アレルゲンの29品目など。別の選択肢が必要な場合は、新しく属性を作成してください。 |
| 識別子(キー) | できない | 「ms_allergens」のような決まった名前になります。 |
属性の並び順を変更する
商品属性グループの編集画面で「⚙ 並べ替え」をクリックすると、ドラッグで属性の並び順を変更できます。
この並び順が、商品ページでの表示順になります。
| 並び順はグループごとではなく、ショップ全体で共通です。どのグループの編集画面で並べ替えても、すべての商品の表示順に反映されます。 |
商品に属性の値を入力する
設定画面:商品管理 / 商品一覧 / 商品編集
- 商品一覧から対象の商品を選択し、商品編集画面を開きます。
- 「商品属性」セクションの「商品属性グループ」で、商品に設定するグループを選択します(複数選択できます)。
- 選択したグループに含まれる属性の入力欄が表示されるので、値を入力します。
- 商品を保存します。
| 商品属性グループを選択していない商品には、属性の値を登録できません(商品編集画面・商品CSV・商品取得APIのいずれも同様です)。 商品からグループを外した結果、どのグループにも含まれなくなった属性がある場合、その属性の値は削除されます。外す操作をした時点で確認ダイアログが表示され、削除される属性の件数を確認できます。削除は商品を保存したときに反映されます。 |
バリエーションごとに値を設定する
商品単位で入力した値を、バリエーションごとに上書きできます。上書きしていないバリエーションには、商品単位の値が使用されます。
商品ページでは、バリエーションを切り替えると属性の表示も切り替わります。
商品ページでの表示は次のとおりです。
| 状況 | 表示 |
|---|---|
| 商品ページを開いたとき | 既定で選択されているバリエーションに値があればその値、なければ商品単位の値を表示します。 |
| 商品単位の値が未入力で、一部のバリエーションにだけ値がある | 値のあるバリエーションが選択されたときに表示されます。値のないバリエーションでは表示されません。 |
| SKUごとに買い物かごを並べて表示する商品 | SKUの一覧表に「属性」列が表示され、そのSKU独自の値(上書きした値)のみが表示されます。商品単位の値は、一覧表とは別に表示されます。 |
| バリエーションごとの値は、商品CSVでは登録できません。商品編集画面から入力してください。 |
商品ページでの表示
値が入力されていて、かつ「商品ページへの表示」がONの属性が、商品説明の下にまとめて表形式で表示されます。表示順は属性の並び順のとおりです。
表示されるのは商品詳細ページのみです。
| やりたいこと | 方法 |
|---|---|
| 決まった形でまとめて表示したい | ノーコードデザインでは、商品詳細セクションの表示項目「商品属性」で表示します。表示位置は商品説明の下です。 |
| 好きな位置・デザインで表示したい | クリエイターモードのテンプレートタグで、識別子を指定して属性を1つずつ表示できます。詳しくはクリエイターモード・商品取得APIでの利用をご確認ください。 |
| 特定の属性だけ商品ページに表示したくない | 属性ごとの「商品ページへの表示」をOFFにします。 |
| 属性の値にHTMLは使用できません。値にHTMLタグを入力しても、タグとしては機能せず文字のまま表示されます。表組みや強調などのデザインは、クリエイターモードでご調整ください。 |
値が未入力のときの表示
値が入力されていない属性は、行ごと商品ページに表示されません。
属性の「値が未入力のときに表示するテキスト」を設定している場合は、値の位置にそのテキストが表示されます。
| アレルゲンの選択肢は、消費者庁の定める29品目(特定原材料9品目+特定原材料に準ずるもの20品目)のみです。「使用していない」という選択肢はありません。 商品ページでお知らせしたい場合は、アレルゲン属性の「値が未入力のときに表示するテキスト」に「対象29品目を使用していません。」のような文言を設定してください。 なお、同じ製造ラインでの混入の可能性がある場合もあるため、混入の可能性を否定する断定的な表現はお控えいただくことをおすすめします。 「同一製造ラインで〇〇を含む製品を製造しています」のような注記は、makeshopが用意した属性「アレルゲンの注意事項」をご利用ください。 |
商品一覧で属性の値を使って絞り込む
設定画面:商品管理 / 商品一覧
- 商品一覧の絞り込みパネルを開きます。
- 「商品属性」欄で、属性と条件を選択します。
- 条件を追加する場合は、条件行を追加します。複数の条件はすべて満たす商品(AND)で絞り込まれます。
商品CSVで入出力する
商品CSVで、属性の値と商品属性グループを登録・出力できます。出力する列は、商品CSVのフォーマット設定で選択してください。
| 列名 | 内容 |
|---|---|
| 属性:〈属性名〉 | 属性ごとの値です。属性名を変更すると、列名も変わります。 |
| 商品属性グループ | 商品に設定するグループを、商品属性グループコード(例:MG00001)で指定します。グループ名では指定できません。1商品につき1グループです。空欄の場合は変更されません。 |
- 値を削除する場合は「NULL」を入力します。空欄の場合は変更されません。
- 商品CSVは1行=1商品のため、バリエーションごとの値は登録できません。
| 次の場合、その行は取り込みエラーになります。 ・商品属性グループが設定されていない商品で、属性の列に値が入力されている ・属性の入力形式と合わない値が入力されている(数値の属性に文字を入力しているなど) CSVで属性名の列を使って運用している場合は、属性名を変更する前に列名への影響をご確認ください。 |
クリエイターモード・商品取得APIでの利用
クリエイターモードのテンプレートタグと商品取得APIでは、識別子で属性を指定します。属性名を変更しても識別子は変わらないため、連携に影響はありません。
商品属性グループは管理画面用の設定のため、商品ページ・商品取得APIには出力されません。
クリエイターモードでは、商品詳細ページのテンプレートの表示したい位置に次のタグを記述すると、属性をまとめて表示できます。表示する属性がない商品では何も出力されません。
<{$item.metafields.list_html}>
| テンプレートタグで利用できるのは、商品詳細ページのみです。商品一覧・カテゴリページなどに記述しても表示されません。 「商品ページへの表示」がOFFの属性は、テンプレートタグにも出力されません。 属性名はショップで変更できるため、テンプレートに属性名を直接記述せず、タグで属性名を出力することをおすすめします。 |
識別子の形式と確認方法
識別子は、属性の作り方によって次の形式になります。
| 属性の作り方 | 識別子の形式 | 例 |
|---|---|---|
| makeshopが用意した属性 | 決まった名前 | ms_allergens、ms_ingredients(用意された属性の一覧) |
| 新しく作成し、識別子を未入力で保存 | 自動で発行される番号(大文字) | MS00001、MS00002 |
| 新しく作成し、識別子を入力 | 「ms_」+入力した名前 | 「sanchi」と入力 → ms_sanchi |
識別子は、商品属性グループの編集画面で属性の編集画面を開き、「識別子(キー)」欄で確認できます。横のコピーボタンからコピーできます。
商品属性グループの編集画面の属性一覧には、識別子は表示されません。
| 大文字と小文字は、画面の表示どおりに指定してください(「MS00001」を「ms00001」と指定すると取得できません)。 ショップで新しく作成した属性は、makeshopが用意した属性と同じ名称でも識別子が異なります。たとえば、ショップで作成した「原材料名」は「ms_ingredients」では取得できません。 |
削除・解除時の注意
商品属性グループの削除と属性の削除では、削除される内容が異なります。
| 操作 | 削除されるもの | 残るもの |
|---|---|---|
| 商品属性グループを削除する | グループと、グループと属性の関連 | 属性と商品の値 |
| 属性を削除する | 属性と、その属性に入力されている全商品の値 | ー |
| グループから属性のチェックを外す | どのグループにも含まれなくなった属性の値 | 属性 |
| 商品からグループを外す | どのグループにも含まれなくなった属性の値(その商品のみ) | 属性、ほかの商品の値 |
| 選択肢を削除して保存する | その選択肢を選択していた商品の値 | 選択肢名の変更のみの場合は、値は保持されます |
| 値が削除される操作では確認ダイアログが表示され、削除される件数(商品数・属性数)を確認できます。確認のチェックを入れるまで実行できません。削除した値は元に戻せませんので、ご注意ください。 商品属性グループを削除した場合、値は残りますが、どのグループにも含まれない属性は商品編集画面に入力欄が表示されず、商品ページにも表示されなくなります。グループを作り直して同じ属性を追加すると、値をそのまま利用できます。 属性を削除したあと、同じ識別子で別の属性を作成すると、クリエイターモードや商品取得APIでは新しい属性の値が出力されます。連携をご利用の場合は、作り直す前に影響をご確認ください。 |
登録上限
| 項目 | 上限 | 補足 |
|---|---|---|
| 属性(1ショップあたり) | 200件 | |
| 商品属性グループ(1ショップあたり) | 100件 | |
| 属性名 | 100文字 | |
| 属性の説明文 | 500文字 | |
| 商品属性グループ名 | 30文字 | 同じ名前のグループは作成できません。 |
| 選択肢(1属性あたり) | 30件 | |
| 選択肢名 | 30文字 | 「|」(半角パイプ)は使用できません。 |
| 数値の単位表記 | 20文字 | |
| 識別子(キー) | 64文字 | 「ms_」を含みます。半角英数字とアンダースコアのみ使用できます。 |
| 値が未入力のときに表示するテキスト | 30文字 | |
| テキスト形式の値 | 1,000文字 | 改行できます。改行はそのまま商品ページに反映されます。 |
| 1商品に適用される属性数 | 20程度(目安) | 設定しているグループに含まれる属性の合計(重複は1つとして数えます)です。 |
よくある質問
属性を作成したのに、商品編集画面に入力欄が表示されません。
属性が商品属性グループに追加されているか、そのグループが商品に設定されているかをご確認ください。商品編集画面の「商品属性」セクションで、商品属性グループが選択されている必要があります。
値を入力したのに、商品ページに表示されません。
次の点をご確認ください。
・ノーコードデザイン/クリエイターモードをご利用か(旧PC・旧スマートフォンデザインは対象外です)
・商品詳細ページを確認しているか(商品一覧・カテゴリページなどには表示されません)
・ノーコードデザインの場合、商品詳細セクションで表示項目「商品属性」を表示しているか
・属性の「商品ページへの表示」がONになっているか
・商品に商品属性グループが設定されているか
・値が入力されているか(バリエーションごとに値を入力している場合は、値のあるバリエーションが選択されているか)
商品ページでの属性の並び順を、グループごとに変えられますか?
できません。並び順はショップ全体で共通です。詳しくは属性の並び順を変更するをご確認ください。
購入者が商品ページで属性の値を使って検索・絞り込みできますか?
できません。属性の値での絞り込みは、管理画面の商品一覧のみ対応しています。
属性の入力を必須にできますか?
できません。属性の入力を必須にする設定はありません。
属性を複製できますか?
できません。同じ設定の属性が必要な場合は、新しく作成してください。