Update a size chart

Requires write_product_sizechart access scope.
For more info, refer to:
access permission.
PUT https://{handle}.myshopline.com/admin/openapi/v20260301/sizechart.json
handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .
Update a size chart. After the update, the product sizes will prioritize displaying the latest data.
Request Headers
  • Content-Type string required
    The field must be set to the fixed value application/json; charset=utf-8.
  • Authorization string required
    The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
Request Body
  • reqobject
    Request parameters.
  • applicable_product_type string
    Specify the scope of products to which the size chart applies. Valid values are:
    • ALL：apply to all products
    • SPECIFIC：apply to specific products
    • COLLECTION：apply to specific product collection
    Default value: ALL
    Example: ALL
  • title string
    Size chart title. It will be truncated if it exceeds the maximum length.
    Maximum length：100
    Example: My SizeChart
  • collection_list array
    When the applicable_product_type is set to COLLECTION, use this field to pass in a list of collection IDs to which the size chart applies.
    Maximum size : 50
    Example: ["12260895952237462871473144"]
  • languages array
    When language_scope is set to SPECIFIC, use this field to pass an array of language codes to which the size chart applies.
    • pt-pt: Portuguese (Portugal)
    • tr: Turkish
    • zh-hans-cn: Simplified Chinese (Mainland China)
    • vi: Vietnamese
    • sv: Swedish
    • zh-hant-tw: Traditional Chinese
    • th: Thai
    • ar: Arabic
    • pl: Polish
    • ro: Romanian
    • sk: Slovak
    • ko: Korean
    • lv: Latvian
    • ms: Malay
    • pt: Portuguese (Brazil)
    • it: Italian
    • ja: Japanese
    • lt: Lithuanian
    • sl: Slovenian
    • nb: Norwegian Bokmål
    • ru: Russian
    • nl: Dutch
    • en: English
    • id: Indonesian
    • et: Estonian
    • bg: Bulgarian
    • hi: Hindi
    • cs: Czech
    • es: Spanish
    • fr: French
    • fi: Finnish
    • da: Danish
    • el: Greek
    • de: German
    • hr: Croatian
    • hu: Hungarian
    Example: ["EN,CN"]
  • product_list array
    When applicable_product_type is set to SPECIFIC, use this field to pass in a list of product IDs to which the size chart applies.
    Maximum size: 100
    Example: ["16064649853088531841170520"]
  • size_chart_id string required
    The unique ID of size chart .
    Example: 13266288837293171311580520
  • applicable_attribute_list array
    A list of product attributes applicable to the size chart, where each attribute can be used to describe product characteristics, such as size.
    Maximum length per string : 255
    Maximum size : 50
    Example: ["size"]
  • language_scope string
    Specify the scope of languages to which the size chart applies. When language_scope = SPECIFIC, the languages cannot be empty and must specify the supported languages. Valid values are:
    • ALL: apply to all languages
    • SPECIFIC: apply to specific languages
    Default value：ALL
    Example: ALL
  • status boolean
    Whether to publish the size chart.
    • true: publish
    • false: not publish
    Default value：false
  • contentsobject[]
    Size data list, to be processed sequentially from the first item, with any items beyond the first 10 being truncated.
    Maximum size: 10
  • text string
    The text content .
    Example: My SizeChart
  • title string
    Size chart title. If the title exceeds the maximum length, it will be truncated.
    Maximum length: 50
    Example: Size Chart
  • type string required
    Enumaration of supported content types in a size chart. Valid values are:
    • SIZE_CHART: indicates a table
    • CROSS_SIZE_CHART: indicates a cross table
    • IMAGE: indicates an image
    • TEXT: indicates text
    • TAB: indicates a tab
    Example: SIZE_CHART
  • url string
    The image content, represented by a URL. Specify this field when the value of type is IMAGE.
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • cross_table_contentobject
    Cross table data that commonly used to display specific sizes suitable for different body parameters. For example, a height of 170cm and a weight of 70kg are suitable for size L.
  • row_unitobject
    The size unit of the rows in the cross table.
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: feet.
    Example: feet
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: cm.
    Example: cm
  • unit_type string
    The unit types supported by cross tables. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: LENGTH
  • size_dataobject[] required
    A list of cross table data, where the first element represents the table header. Each element in the array corresponds to a row of data in the table.
    Maximum size: 50
  • row_data array required
    A list of cross table row data, where each element in the array represents data within a cell.
    Maximum size: 50
    Maximum length per string: 19
    Example: ["XS,64"]
  • column_title string
    The column title in a cross table that indicates the size information represented by the column data. For example, weight denotes that the column data represents weight data.
    Default value: weight
    Maximum length：20
    Example: weight
  • column_unitobject
    The size unit of the column's data in the cross table.
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: kg.
    Example: kg
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: lb.
    Example: lb
  • unit_type string
    The unit types supported by cross tables. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: WEIGHT
  • remark string
    Cross table remark.
    Maximum length：255
    Example: 1 lb = 0.45 kg，1 feet = 30.48 cm
  • row_title string
    The row title in a cross table that explains the size information represented by the row data. For example, height denotes that the row data represents height data.
    Default value: height
    Maximum length: 20
    Example: height
  • table_contentobject
    Table data that commonly used to display size data in tabular form. For example, the shoulder width for size S is 60, and the waist circumference is 55.
  • remark string
    Table remark.
    Maximum length: 255
    Example: 1inch=2.54cm
  • size_dataobject[] required
    A list of cross table data, where the first element represents the table header. Each element in the array corresponds to a row of data in the table.
    Maximum size: 50
  • row_data array required
    A list of cross table data, where the first element represents the table header. Each element in the array corresponds to a row of data in the table.
    Maximum size: 50
    Example: ["XS,64"]
  • unitobject
    The unit of measurement used for the size data in the table.
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: cm.
    Example: cm
  • unit_type string
    The unit types supported by table. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: LENGTH
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: in.
    Example: in
  • country_sizeobject
    The country size data represents the names of sizes in different countries within this table.
  • country_size_dataobject[] required
    The country size data, where the first element of the array represents the country, and the other elements represent the names of different sizes in that country.
  • country string required
    Country name.
    Maximum length per name：19
    Example: United States
  • data array required
    A list of names for different sizes in a country.
    Maximum size: 21
    Maximum length per string: 19
    Example: ["78,89"]
  • cover_attribute boolean
    Whether to use country_size_data to override the default size values.
    ● true：override
    ● false：not override
    Default value：false
  • status boolean
    Whether to turn on the country size switch.
    ● true：turn on the switch.
    ● false：turn off the switch.
    Default value：false
    Example: true
  • tabsobject[]
    A list of tab data that allows for multiple tab columns with various types of size data content within each tab.
    Maximum size : 5
  • tab_contentobject[]
    A list of tab column data.
    Maximum size: 10
  • cross_table_contentobject
    Cross table data that commonly used to display specific sizes suitable for different body parameters. For example, a height of 170cm and a weight of 70kg are suitable for size L.
  • column_title string
    The column title in a cross table that indicates the size information represented by the column data. For example, weight denotes that the column data represents weight data.
    Default value: weight
    Maximum length：20
    Example: weight
  • column_unitobject
    The size unit of the columns in the cross table.
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: kg.
    Example: kg
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: lb.
    Example: lb
  • unit_type string
    The unit types supported by cross tables. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: WEIGHT
  • remark string
    Cross table remark.
    Maximum length：255
    Example: 1 lb = 0.45 kg，1 feet = 30.48 cm
  • row_title string
    The row title in a cross table that explains the size information represented by the row data. For example, height denotes that the row data represents height data.
    Default value: height
    Maximum length: 20
    Example: height
  • row_unitobject
    The size unit of the rows in the cross table.
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: cm.
    Example: cm
  • unit_type string
    The unit types supported by cross tables. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: LENGTH
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: feet.
    Example: feet
  • size_dataobject[] required
    A list of table data, where the first element represents the table header. Each element in the array corresponds to a row of data in the table.
    Maximum size: 50
  • row_data array required
    A list of cross table row data, where each element in the array represents data within a cell.
    Maximum size: 50
    Maximum length per string: 19
    Example: ["XS,64"]
  • table_contentobject
    Table data that commonly used to display size data in tabular form. For example, the shoulder width for size S is 60, and the waist circumference is 55.
  • country_sizeobject
    The country size data, representing size names in different countries.
  • country_size_dataobject[] required
    The country size data, where the first element of the array represents the country, and the other elements represent the names of different sizes in that country.
  • country string required
    Country name.
    Maximum length：19
    Example: US
  • data array required
    A list of names for different sizes in a country.
    Maximum size: 21
    Maximum length per string: 19
    Example: ["78,89"]
  • cover_attribute boolean
    Whether to use country_size_data to override the default size values.
    ● true：override
    ● false：not override
    Default value：false
  • status boolean
    Whether to turn on the country size switch.
    ● true：turn on the switch
    ● false：turn off the switch
    Default value：false
    Example: true
  • remark string
    Table remark.
    Maximum length: 255
    Example: 1inch=2.54cm
  • size_dataobject[] required
    A list of table data, where the first element represents the table header. Each element in the array corresponds to a row of data in the table.
    Maximum size: 50
  • row_data array required
    A list of cross table row data, where each element in the array represents data within a cell.
    Maximum size: 50
    Maximum length per string: 19
    Example: ["XS,64"]
  • unitobject
    The unit of measurement used for the size data in the table.
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: in.
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: cm.
  • unit_type string
    The unit types supported by table. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
  • tabsobject[]
    Secondary tab data structure where tabs can be nested under tabs to create a second-level tab effect, with a maximum nesting level of 2.
    Maximum size : 5
  • tab_contentobject[]
    Secondary tab data structure where tabs can be nested under tabs to create a second-level tab effect, with a maximum nesting level of 2.
    Maximum size of tab column per tab : 5
  • type string required
    Enumaration of supported content types in secondary tab. Valid values are:
    • SIZE_CHART: indicates a table
    • CROSS_SIZE_CHART: indicates a cross table
    • IMAGE: indicates an image
    • TEXT: indicates text
  • url string
    The image under the tab, represented by a URL. Specify this field when the value of type is IMAGE.
  • cross_table_contentobject
    Cross table data that commonly used to display specific sizes suitable for different body parameters. For example, a height of 170cm and a weight of 70kg are suitable for size L.
  • column_unitobject
    The size unit of the columns in the cross table.
  • unit_type string
    The unit types supported by cross tables. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: WEIGHT
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: kg.
    Example: kg
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: lb.
    Example: lb
  • remark string
    Cross table remark.
    Maximum length：255
    Example: 1 lb = 0.45 kg，1 feet = 30.48 cm
  • row_title string
    The row title in a cross table that explains the size information represented by the row data. For example, height denotes that the row data represents height data.
    Default value: height
    Maximum length: 20
    Example: height
  • row_unitobject
    The size unit of the rows in the cross table.
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: feet.
    Example: feet
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: cm.
    Example: cm
  • unit_type string
    The unit types supported by cross tables. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: LENGTH
  • size_dataobject[] required
    A list of table data, where the first element represents the table header. Each element in the array corresponds to a row of data in the table.
    Maximum size: 50
  • row_data array required
    A list of cross table row data, where each element in the array represents data within a cell.
    Maximum size: 50
    Maximum length per string: 19
    Example: ["XS,64"]
  • column_title string
    The column title in a cross table that indicates the size information represented by the column data. For example, weight denotes that the column data represents weight data.
    Default value: weight
    Maximum length：20
    Example: weight
  • table_contentobject
    Table data that commonly used to display size data in tabular form. For example, the shoulder width for size S is 60, and the waist circumference is 55.
  • size_dataobject[] required
    A list of table data, where the first element represents the table header. Each element in the array corresponds to a row of data in the table.
    Maximum size: 50
  • row_data array required
    A list of cross table row data, where each element in the array represents data within a cell.
    Maximum size: 50
    Maximum length per string: 19
    Example: ["XS,64"]
  • unitobject
    The unit of measurement used for the size data in the table.
  • default_unit string
    The default display unit for the size data. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: cm.
    Example: cm
  • unit_type string
    The unit types supported by table. Valid values are:
    • LENGTH: length
    • WEIGHT(default value): weight
    • BULK: volume
    The following table shows the specific measurement units supported by each unit type.
    Unit TypeUnit Type DescriptionSupported UnitSupported Unit Description
    LENGTHLengthfeetFeet
    LENGTHLengthmMeters
    LENGTHLengthcmCentimeters
    LENGTHLengthmmMillimeters
    LENGTHLengthinInches
    WEIGHTWeight (Default)lbPounds
    WEIGHTWeight (Default)ozOunces
    WEIGHTWeight (Default)kgKilograms
    WEIGHTWeight (Default)gGrams
    WEIGHTWeight (Default)mgMilligrams
    BULKVolumeus_galGallon (US)
    BULKVolumeuk_galGallon (UK)
    BULKVolumeoz_usFluid Ounce (US)
    BULKVolumeoz_ukFluid Ounce (UK)
    BULKVolumemlMilliliters
    BULKVolumelLiters
    Example: LENGTH
  • convert_unit string
    The optional display unit for the size data. Customers can switch between the default unit (default_unit) and this unit to display sizes. Refer to the table in the unit_type description for valid values of this field. You need to set a supported unit based on the specified unit_type.
    Default value: in.
    Example: in
  • country_sizeobject
    The country size data, representing size names in different countries.
  • country_size_dataobject[] required
    The country size data, where the first element of the array represents the country, and the other elements represent the names of different sizes in that country.
  • country string required
    Country name.
    Maximum length per name：19
    Example: US
  • data array required
    A list of names for different sizes in a country.
    Maximum size: 21
    Maximum length per string: 19
    Example: ["78,89"]
  • cover_attribute boolean
    Whether to use country_size_data to override the default size values.
    ● true：override
    ● false：not override
    Default value：false
  • status boolean
    Whether to turn on the country size switch.
    ● true：turn on the switch.
    ● false：turn off the switch.
    Default value：false
    Example: true
  • remark string
    Table remark.
    Maximum length: 255
    Example: 1inch=2.54cm
  • text string
    The text content under the tab.
    Example: My SizeChart
  • title string
    Size chart title. If the title exceeds the maximum length, it will be truncated.
    Maximum length: 50
  • tab_name string required
    The name of tab column.
    Maximum length : 50
  • text string
    The text content under the tab.
    Example: My SizeChart
  • title string
    Size chart title. If the title exceeds the maximum length, it will be truncated.
    Maximum length: 50
    Example: Size Chart
  • type string required
    Enumaration of supported content types in tab. Valid values are:
    • SIZE_CHART: indicates a table
    • CROSS_SIZE_CHART: indicates a cross table
    • IMAGE: indicates an image
    • TEXT: indicates text
    • TAB: indicates a tab
    Example: SIZE_CHART
  • url string
    The image under the tab, represented by a URL. Specify this field when the value of type is IMAGE.
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • tab_name string required
    The name of tab column.
    Maximum length : 50
Status Codes
For the complete list of codes and messages, see Http status code.
Response Headers
  • traceId
    A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.
Response Body
  • dataobject
    Response data.
  • size_chart_id string
    Size chart ID.
    Example: 13266288837293171311580520
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

— header required

Body

required
{
  "req": {
    "applicable_product_type": "ALL",
    "language_scope": "ALL",
    "languages": [
      "EN,CN"
    ],
    "size_chart_id": "13266288837293171311580520",
    "applicable_attribute_list": [
      "size"
    ],
    "status": false,
    "collection_list": [
      "12260895952237462871473144"
    ],
    "contents": [
      {
        "table_content": {
          "country_size": {
            "status": true,
            "country_size_data": [
              {
                "country": "United States",
                "data": [
                  "78,89"
                ]
              }
            ],
            "cover_attribute": false
          },
          "remark": "1inch=2.54cm",
          "size_data": [
            {
              "row_data": [
                "XS,64"
              ]
            }
          ],
          "unit": {
            "convert_unit": "in",
            "default_unit": "cm",
            "unit_type": "LENGTH"
          }
        },
        "tabs": [
          {
            "tab_name": "",
            "tab_content": [
              {
                "table_content": {
                  "remark": "1inch=2.54cm",
                  "size_data": [
                    {
                      "row_data": [
                        "XS,64"
                      ]
                    }
                  ],
                  "unit": {
                    "default_unit": "",
                    "unit_type": "",
                    "convert_unit": ""
                  },
                  "country_size": {
                    "cover_attribute": false,
                    "status": true,
                    "country_size_data": [
                      {
                        "country": "US",
                        "data": [
                          "78,89"
                        ]
                      }
                    ]
                  }
                },
                "tabs": [
                  {
                    "tab_content": [
                      {
                        "cross_table_content": {
                          "column_title": "weight",
                          "column_unit": {
                            "convert_unit": "kg",
                            "default_unit": "lb",
                            "unit_type": "WEIGHT"
                          },
                          "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm",
                          "row_title": "height",
                          "row_unit": {
                            "convert_unit": "feet",
                            "default_unit": "cm",
                            "unit_type": "LENGTH"
                          },
                          "size_data": [
                            {
                              "row_data": [
                                "XS,64"
                              ]
                            }
                          ]
                        },
                        "table_content": {
                          "country_size": {
                            "country_size_data": [
                              {
                                "country": "US",
                                "data": [
                                  "78,89"
                                ]
                              }
                            ],
                            "cover_attribute": false,
                            "status": true
                          },
                          "remark": "1inch=2.54cm",
                          "size_data": [
                            {
                              "row_data": [
                                "XS,64"
                              ]
                            }
                          ],
                          "unit": {
                            "convert_unit": "in",
                            "default_unit": "cm",
                            "unit_type": "LENGTH"
                          }
                        },
                        "text": "My SizeChart",
                        "title": "",
                        "type": "",
                        "url": ""
                      }
                    ],
                    "tab_name": ""
                  }
                ],
                "text": "My SizeChart",
                "title": "Size Chart",
                "type": "SIZE_CHART",
                "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png",
                "cross_table_content": {
                  "row_title": "height",
                  "row_unit": {
                    "unit_type": "LENGTH",
                    "convert_unit": "feet",
                    "default_unit": "cm"
                  },
                  "size_data": [
                    {
                      "row_data": [
                        "XS,64"
                      ]
                    }
                  ],
                  "column_title": "weight",
                  "column_unit": {
                    "convert_unit": "kg",
                    "default_unit": "lb",
                    "unit_type": "WEIGHT"
                  },
                  "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm"
                }
              }
            ]
          }
        ],
        "text": "My SizeChart",
        "title": "Size Chart",
        "type": "SIZE_CHART",
        "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png",
        "cross_table_content": {
          "column_title": "weight",
          "column_unit": {
            "convert_unit": "kg",
            "default_unit": "lb",
            "unit_type": "WEIGHT"
          },
          "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm",
          "row_title": "height",
          "row_unit": {
            "convert_unit": "feet",
            "default_unit": "cm",
            "unit_type": "LENGTH"
          },
          "size_data": [
            {
              "row_data": [
                "XS,64"
              ]
            }
          ]
        }
      }
    ],
    "product_list": [
      "16064649853088531841170520"
    ],
    "title": "My SizeChart"
  }
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/sizechart.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
Update a size chart
Request
{
  "req": {
    "status": true,
    "collection_list": null,
    "language_scope": "SPECIFIC",
    "size_chart_id": "13268300202703737403692275",
    "applicable_product_type": "SPECIFIC",
    "contents": [
      {
        "url": null,
        "cross_table_content": null,
        "table_content": {
          "country_size": null,
          "remark": "1inch=2.54cm",
          "size_data": [
            {
              "row_data": [
                "SIZE",
                "LENGTH",
                "BUST",
                "SHOULDER",
                "SLEEVE"
              ]
            },
            {
              "row_data": [
                "XS",
                "64",
                "91",
                "35",
                "53"
              ]
            },
            {
              "row_data": [
                "S",
                "66",
                "94",
                "35.5",
                "56"
              ]
            },
            {
              "row_data": [
                "M",
                "69",
                "96",
                "36.5",
                "58"
              ]
            },
            {
              "row_data": [
                "L",
                "71",
                "98",
                "38",
                "60"
              ]
            }
          ],
          "unit": {
            "default_unit": "cm",
            "unit_type": "LENGTH",
            "convert_unit": "in"
          }
        },
        "tabs": null,
        "text": null,
        "title": "Size Chart",
        "type": "SIZE_CHART"
      },
      {
        "table_content": null,
        "tabs": null,
        "text": "<p><strong>Sizes can vary from 2-3 centimeters because they are measured by hand.&nbsp;</strong></p>",
        "title": null,
        "type": "TEXT",
        "url": null,
        "cross_table_content": null
      },
      {
        "title": null,
        "type": "IMAGE",
        "url": "https://cdn.myshopline.com/image/size-chart/detail/content_model.png",
        "cross_table_content": null,
        "table_content": null,
        "tabs": null,
        "text": null
      },
      {
        "title": "Cross Size Chart",
        "type": "CROSS_SIZE_CHART",
        "url": null,
        "cross_table_content": {
          "row_title": "height",
          "row_unit": {
            "unit_type": "LENGTH",
            "convert_unit": "feet",
            "default_unit": "cm"
          },
          "size_data": [
            {
              "row_data": [
                "",
                "170-180",
                "180-190",
                "190-200"
              ]
            },
            {
              "row_data": [
                "60-70",
                "L",
                "XL",
                "XXL"
              ]
            },
            {
              "row_data": [
                "70-80",
                "XL",
                "XL",
                "XXL"
              ]
            },
            {
              "row_data": [
                "80-90",
                "XXL",
                "XXL",
                "XXL"
              ]
            }
          ],
          "column_title": "weight",
          "column_unit": {
            "convert_unit": "kg",
            "default_unit": "lb",
            "unit_type": "WEIGHT"
          },
          "remark": null
        },
        "table_content": null,
        "tabs": null,
        "text": null
      },
      {
        "url": null,
        "cross_table_content": null,
        "table_content": null,
        "tabs": [
          {
            "tab_content": [
              {
                "tabs": [
                  {
                    "tab_content": [
                      {
                        "type": "SIZE_CHART",
                        "url": null,
                        "cross_table_content": null,
                        "table_content": {
                          "remark": "1inch = 2.54cm",
                          "size_data": [
                            {
                              "row_data": [
                                "SIZE",
                                "UNDER BUST",
                                "CUP HEIGHT"
                              ]
                            },
                            {
                              "row_data": [
                                "S",
                                "24.4",
                                "5.3"
                              ]
                            },
                            {
                              "row_data": [
                                "M",
                                "26",
                                "5.7"
                              ]
                            },
                            {
                              "row_data": [
                                "L",
                                "27.6",
                                "6.2"
                              ]
                            }
                          ],
                          "unit": {
                            "default_unit": "cm",
                            "unit_type": "LENGTH",
                            "convert_unit": "in"
                          },
                          "country_size": null
                        },
                        "text": null,
                        "title": "Size Chart"
                      },
                      {
                        "text": "<p><strong>Sizes can vary from 2-3 centimeters because they are measured by hand.&nbsp;</strong></p>",
                        "title": null,
                        "type": "TEXT",
                        "url": null,
                        "cross_table_content": null,
                        "table_content": null
                      }
                    ],
                    "tab_name": "TOP"
                  },
                  {
                    "tab_content": [
                      {
                        "cross_table_content": null,
                        "table_content": {
                          "size_data": [
                            {
                              "row_data": [
                                "SIZE",
                                "bottom length\t",
                                "bottom waist"
                              ]
                            },
                            {
                              "row_data": [
                                "S",
                                "31.7-8.7",
                                "22.0"
                              ]
                            },
                            {
                              "row_data": [
                                "M",
                                "32.1-9.1",
                                "23.6"
                              ]
                            },
                            {
                              "row_data": [
                                "L",
                                "32.5-9.4",
                                "25.2"
                              ]
                            }
                          ],
                          "unit": {
                            "convert_unit": "in",
                            "default_unit": "cm",
                            "unit_type": "LENGTH"
                          },
                          "country_size": null,
                          "remark": "1inch = 2.54cm"
                        },
                        "text": null,
                        "title": "Size Chart",
                        "type": "SIZE_CHART",
                        "url": null
                      },
                      {
                        "table_content": null,
                        "text": "<p><strong>Sizes can vary from 2-3 centimeters because they are measured by hand.&nbsp;</strong></p>",
                        "title": null,
                        "type": "TEXT",
                        "url": null,
                        "cross_table_content": null
                      }
                    ],
                    "tab_name": "BOTTOM"
                  }
                ],
                "text": null,
                "title": null,
                "type": "TAB",
                "url": null,
                "cross_table_content": null,
                "table_content": null
              }
            ],
            "tab_name": "Product Measurements"
          },
          {
            "tab_content": [
              {
                "type": "IMAGE",
                "url": "https://d2n979dmt31clo.cloudfront.net/image/rule/1709518999861/dce7fffb9108427a854708b7379d8346.png?w=1740&h=1317",
                "cross_table_content": null,
                "table_content": null,
                "tabs": null,
                "text": null,
                "title": null
              }
            ],
            "tab_name": "Body Measurements"
          }
        ],
        "text": null,
        "title": null,
        "type": "TAB"
      }
    ],
    "languages": [
      "en"
    ],
    "product_list": [
      "16067821420558192659742275"
    ],
    "title": "sizechart_en",
    "applicable_attribute_list": [
      "size"
    ]
  }
}
Response
{
  "data": {
    "size_chart_id": "13268300202703737403692275"
  }
}
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.