Sign Customiser

Partially update the customiser's labels with a JSON Merge Patch (RFC 7396) of the document the read operation returns: the request body is a JSON object containing only the labels to change.

PATCH/api/v3/customisers/{customiser_id}/labels

Overview

Labels omitted from the patch are unchanged, a null value clears a label so the storefront falls back to its built-in default copy, and an empty object {} is a valid no-op. A label this resource does not define is refused with a JSON Pointer rather than ignored, so a typo can never silently change meaning. Requires the customisers:write scope. Nine properties the read publishes are read-only and are refused with their own pointer: the object, customiser_id and updated_at descriptors, the three file-bearing labels product_image_url, background_images and additional_information, and the three list labels highlights, qualities and custom_design_steps — the read operation explains why each group is held back. The section switches take a boolean, never null. A successful update immediately changes the storefront: the customiser's cached configuration is invalidated and translated language content is resynchronised, so a label you change is queued for retranslation into every language the customiser publishes. It never regenerates your Shopify products, product images, or product cache. Send an Idempotency-Key header (1-255 visible ASCII characters, e.g. a UUID) to make the write safe to retry: repeating the same key with the same body replays the original response (marked Idempotency-Replay: true) without executing again; the same key with a different body is a 409 problem with code idempotency_key_conflict. The header is optional here, as on the option families' update operations. Validation failures are 422 problems: validation_failed lists every field error in errors[] with a JSON pointer and, for closed-set violations, the allowed_values; unknown_field means the body names labels outside the document. A label whose current copy carries placeholder tokens (such as {width} or {price}) must keep them, or the write is refused on that label's pointer — the storefront substitutes real values into those tokens and dropping one would print the placeholder to a shopper. A 400 problem means the body is not valid JSON or the Idempotency-Key header is malformed. 401/403/404/429 behave as on the read operation, with customisers:write as the required scope.

Authorisation

Bearer token required. Include it in theAuthorization header.

Required scope: customisers:write

Path parameters

customiser_idstringpathrequired

The customiser id, from the list customisers operation.

Example: 1

Request body

adding_to_cartstringbody
allow_custom_backgroundbooleanbody
apply_stylestringbody
aspect_ratio_warningstringbody
backboard_upload_errorstringbody
backgroundsstringbody
backlight_titlestringbody
border_includedstringbody
bottom_sidestringbody
braille_fixed_size_info_labelstringbody
braille_frame_too_small_messagestringbody
braille_overview_fitted_to_screen_labelstringbody
braille_translation_failed_messagestringbody
braille_translation_pending_messagestringbody
braille_untranslatable_modal_button_labelstringbody
braille_untranslatable_modal_labelstringbody
cancelstringbody
char_limit_reachedstringbody
character_limit_messagestringbody
character_textstringbody
click_word_desktopstringbody
cm_buttonstringbody
colour_min_size_messagestringbody
colour_titlestringbody
contact_descriptionstringbody
contact_headerstringbody
copy_buttonstringbody
create_product_failedstringbody
creating_productstringbody
crop_confirmstringbody
crop_modal_titlestringbody
crop_uploadstringbody
custom_design_button_labelstringbody
custom_design_form_file_labelstringbody
custom_design_form_input_errorstringbody
custom_design_form_message_errorstringbody
custom_design_form_message_successstringbody
custom_design_form_size_errorstringbody
custom_design_form_submit_messagestringbody
custom_design_form_total_size_errorstringbody
custom_design_steps_headerstringbody
custom_design_tab_titlestringbody
custom_design_typestringbody
custom_sizing_messagestringbody
default_textstringbody
display_initial_background_imagebooleanbody
display_initial_review_imagebooleanbody
edit_designstringbody
editing_wordstringbody
etsy_buttonstringbody
etsy_copied_buttonstringbody
etsy_copy_details_buttonstringbody
etsy_customisation_summary_labelstringbody
etsy_download_preview_buttonstringbody
etsy_listing_url_missingstringbody
etsy_preparing_imagestringbody
etsy_preview_errorstringbody
etsy_return_buttonstringbody
etsy_step1stringbody
etsy_step2stringbody
etsy_step3stringbody
etsy_suggested_price_labelstringbody
etsy_summary_colour_labelstringbody
etsy_summary_descriptionstringbody
etsy_summary_design_labelstringbody
etsy_summary_face_colour_labelstringbody
etsy_summary_halo_colour_labelstringbody
etsy_summary_icon_labelstringbody
etsy_summary_line_labelstringbody
etsy_summary_nostringbody
etsy_summary_not_selectedstringbody
etsy_summary_side_colour_labelstringbody
etsy_summary_titlestringbody
etsy_summary_trim_colour_labelstringbody
etsy_summary_tube_colour_labelstringbody
etsy_summary_uploaded_design_labelstringbody
etsy_summary_yesstringbody
examplestringbody
extra_colour_exclusion_messagestringbody
extras_titlestringbody
file_labelstringbody
file_upload_labelstringbody
font_titlestringbody
generating_imagestringbody
header_textstringbody
height_inputstringbody
icon_button_labelstringbody
icon_titlestringbody
inch_buttonstringbody
inclusionsstringbody
inclusions_headerstringbody
invalid_charactersstringbody
jacket_colour_exclusion_messagestringbody
jacket_titlestringbody
label_under_pricestringbody
left_sidestringbody
letter_parts_descriptionstringbody
letter_parts_titlestringbody
lightbox_product_type_titlestringbody
line_limit_reachedstringbody
lines_textstringbody
loading_manual_clear_textstringbody
logo_button_textstringbody
logo_textstringbody
logo_upload_design_readystringbody
logo_upload_failed_descriptionstringbody
logo_upload_failed_titlestringbody
logo_upload_file_too_largestringbody
logo_upload_form_descriptionstringbody
logo_upload_form_email_placeholderstringbody
logo_upload_form_name_placeholderstringbody
logo_upload_form_submit_buttonstringbody
logo_upload_form_submitted_descriptionstringbody
logo_upload_form_submitted_titlestringbody
logo_upload_form_titlestringbody
logo_upload_pending_descriptionstringbody
logo_upload_pending_titlestringbody
logo_upload_try_anotherstringbody
main_tab_titlestringbody
manual_buttonstringbody
material_mounting_exclusion_messagestringbody
material_support_exclusion_messagestringbody
material_titlestringbody
max_sign_charstringbody
max_sign_modal_button_labelstringbody
max_sign_modal_labelstringbody
min_character_messagestringbody
min_height_sign_warningstringbody
mounting_colour_exclusion_messagestringbody
mounting_colour_min_size_messagestringbody
mounting_colour_titlestringbody
mounting_letter_part_titlestringbody
mounting_support_exclusion_messagestringbody
mounting_titlestringbody
options_tabstringbody
preview_notestringbody
pricestringbody
price_after_labelstringbody
price_box_textstringbody
price_button_addstringbody
price_button_finishstringbody
product_titlestringbody
product_type_titlestringbody
qualities_headerstringbody
quote_buttonstringbody
recenterstringbody
recenter_warningstringbody
retrystringbody
right_sidestringbody
rotationstringbody
shape_finished_sizestringbody
shape_proportions_fixed_bystringbody
shape_size_adjusted_to_fixed_proportionsstringbody
shape_size_adjusted_to_rangestringbody
shape_sizing_empty_feasible_rangestringbody
shape_sizing_invalid_canonical_boundsstringbody
shape_sizing_invalid_intentstringbody
shape_sizing_preset_requires_customstringbody
share_designstringbody
share_design_modal_descriptionstringbody
share_design_modal_titlestringbody
show_background_previewbooleanbody
show_contact_sectionbooleanbody
show_custom_designbooleanbody
show_custom_design_linkbooleanbody
show_inclusion_sectionbooleanbody
show_preview_notebooleanbody
show_review_imagesbooleanbody
show_review_sectionbooleanbody
show_styled_notebooleanbody
show_text_editor_overlaybooleanbody
sign_headerstringbody
size_titlestringbody
slider_buttonstringbody
summary_headerstringbody
support_colour_min_size_messagestringbody
support_colour_titlestringbody
support_titlestringbody
tap_word_mobilestringbody
text_align_centerstringbody
text_align_leftstringbody
text_align_rightstringbody
text_align_titlestringbody
text_button_labelstringbody
text_labelstringbody
text_orientation_horizontalstringbody
text_orientation_titlestringbody
text_orientation_vertical_stackedstringbody
text_titlestringbody
top_sidestringbody
upload_backgroundstringbody
uploading_imagesstringbody
user_bg_scale_cancelstringbody
user_bg_scale_continuestringbody
user_bg_scale_descriptionstringbody
user_bg_scale_errorstringbody
user_bg_scale_titlestringbody
visualiser_offstringbody
visualiser_onstringbody
width_inputstringbody
zoom_instringbody
zoom_outstringbody

Request body example

application/json
{
  "adding_to_cart": "Adding to Cart",
  "allow_custom_background": true,
  "apply_style": "Apply to all",
  "aspect_ratio_warning": "Values may be modified to maintain the required aspect ratio",
  "backboard_upload_error": "Maximum upload size 2mb",
  "backgrounds": "Backgrounds",
  "backlight_title": "Backlight",
  "border_included": "(includes {border} border)",
  "bottom_side": "Bottom",
  "braille_fixed_size_info_label": "Braille dots stay at their accessibility-standard size; larger sign sizes carry larger tactile lettering.",
  "braille_frame_too_small_message": "Choose a bigger sign size so the braille can fit at its fixed size.",
  "braille_overview_fitted_to_screen_label": "Overview — fitted to screen",
  "braille_translation_failed_message": "Braille translation could not refresh. Please try again.",
  "braille_translation_pending_message": "Translating to Braille…",
  "braille_untranslatable_modal_button_label": "Get a custom quote",
  "braille_untranslatable_modal_label": "Some of your text cannot be turned into braille automatically. Send us your design and we will quote it for you.",
  "cancel": "Cancel",
  "char_limit_reached": "You have exceeded the maximum number of characters for the current size.",
  "character_limit_message": "The maximum number of characters for this current size has been reached.",
  "character_text": "characters max per line for current size",
  "click_word_desktop": "Click on a word to begin customising it.",
  "cm_button": "Use cm",
  "colour_min_size_message": "The selected colour is only available for larger sizes.",
  "colour_title": "Color",
  "contact_description": "Feel free to reach out through our Live Chat, read through our FAQ page or send us an email.",
  "contact_header": "Have some questions? We're here for you!",
  "copy_button": "Copy",
  "create_product_failed": "Something went wrong",
  "creating_product": "Creating Product",
  "crop_confirm": "Confirm",
  "crop_modal_title": "Resize your image",
  "crop_upload": "Upload your own image",
  "custom_design_button_label": "Got a logo? Get a quote",
  "custom_design_form_file_label": "Accepted file types include JPEG, PNG, SVG, PDF, AI and EPS.",
  "custom_design_form_input_error": "Invalid input.",
  "custom_design_form_message_error": "Form submission failed. Please try again.",
  "custom_design_form_message_success": "Thank you for your submission.",
  "custom_design_form_size_error": "File size cannot exceed 10MB.",
  "custom_design_form_submit_message": "Submitting form, please wait.",
  "custom_design_form_total_size_error": "Total file size cannot exceed 20MB.",
  "custom_design_steps_header": "How it works",
  "custom_design_tab_title": "Custom",
  "custom_design_type": "form",
  "custom_sizing_message": "Enter text to set a custom size",
  "default_text": "Start Typing",
  "display_initial_background_image": true,
  "display_initial_review_image": true,
  "edit_design": "Edit my design",
  "editing_word": "Editing",
  "etsy_button": "Continue to Etsy",
  "etsy_copied_button": "Copied",
  "etsy_copy_details_button": "Copy details",
  "etsy_customisation_summary_label": "Customisation summary",
  "etsy_download_preview_button": "Download preview",
  "etsy_listing_url_missing": "Your Etsy listing link hasn't been set up yet. Contact the shop to get the link.",
  "etsy_preparing_image": "Preparing image",
  "etsy_preview_error": "Preview couldn't be generated. Please try again.",
  "etsy_return_button": "Return To Etsy To Place An Order",
  "etsy_step1": "Copy your details",
  "etsy_step2": "Return to Etsy",
  "etsy_step3": "Paste into the personalisation box",
  "etsy_suggested_price_label": "Suggested price",
  "etsy_summary_colour_label": "Colour",
  "etsy_summary_description": "Copy these details into the personalisation box on Etsy, then add this item to your basket there.",
  "etsy_summary_design_label": "Design",
  "etsy_summary_face_colour_label": "Face",
  "etsy_summary_halo_colour_label": "Halo",
  "etsy_summary_icon_label": "Icon",
  "etsy_summary_line_label": "Line",
  "etsy_summary_no": "No",
  "etsy_summary_not_selected": "Not selected",
  "etsy_summary_side_colour_label": "Side",
  "etsy_summary_title": "Your Etsy order details",
  "etsy_summary_trim_colour_label": "Trim",
  "etsy_summary_tube_colour_label": "Tube",
  "etsy_summary_uploaded_design_label": "Uploaded design",
  "etsy_summary_yes": "Yes",
  "example": "Example",
  "extra_colour_exclusion_message": "The selected option is not available with this colour.",
  "extras_title": "Extras",
  "file_label": "Upload your logo",
  "file_upload_label": "Drop an image here or tap to browse",
  "font_title": "Font",
  "generating_image": "Generating Image",
  "header_text": "CREATE YOUR CUSTOM SIGN",
  "height_input": "Height",
  "icon_button_label": "Icons",
  "icon_title": "Icons",
  "inch_button": "Use inches",
  "inclusions": "Your Custom Sign\nPower Supply\nDigital Installation Guide\nFree Express Shipping\n12-Month Warranty",
  "inclusions_header": "What's included in your custom sign?",
  "invalid_characters": "Text contains invalid characters: {characters}. Please try another font.",
  "jacket_colour_exclusion_message": "The selected jacket option is not available for this colour.",
  "jacket_title": "Jacket",
  "label_under_price": "",
  "left_side": "Left",
  "letter_parts_description": "",
  "letter_parts_title": "",
  "lightbox_product_type_title": "Lightbox",
  "line_limit_reached": "You have exceeded the maximum number of lines for the current size.",
  "lines_text": "lines",
  "loading_manual_clear_text": "Your design is being added to the cart. Please wait...",
  "logo_button_text": "Submit Custom Design",
  "logo_text": "To Submit a Custom Design, please click on the button below",
  "logo_upload_design_ready": "Design Ready!",
  "logo_upload_failed_description": "Fill out the form to send us an inquiry, we'll automatically attach this image",
  "logo_upload_failed_title": "We couldn't process your image",
  "logo_upload_file_too_large": "This file is too large. Choose a file up to {limit} MB.",
  "logo_upload_form_description": "We'll keep processing your file and send the customisable version to your email when ready.",
  "logo_upload_form_email_placeholder": "Your email",
  "logo_upload_form_name_placeholder": "Your name",
  "logo_upload_form_submit_button": "Submit Request",
  "logo_upload_form_submitted_description": "We'll process your image in the background and email you when it's ready.",
  "logo_upload_form_submitted_title": "Request Submitted!",
  "logo_upload_form_title": "Taking longer than expected?",
  "logo_upload_pending_description": "Depending on the complexity of the image, this may take a few minutes.",
  "logo_upload_pending_title": "Processing your image",
  "logo_upload_try_another": "Try another image",
  "main_tab_title": "Text",
  "manual_button": "Enter dimensions manually",
  "material_mounting_exclusion_message": "The selected material is not available with this mounting option.",
  "material_support_exclusion_message": "The selected material is not available with this backboard.",
  "material_title": "Material",
  "max_sign_char": "characters max",
  "max_sign_modal_button_label": "Get a quote",
  "max_sign_modal_label": "Size is over the limit. Contact us for a quote.",
  "min_character_message": "or more characters are required for this size, please add more characters.",
  "min_height_sign_warning": "The overall sign height is too small. Please increase the height.",
  "mounting_colour_exclusion_message": "The selected mounting option is not available with this colour.",
  "mounting_colour_min_size_message": "This colour requires a larger sign size.",
  "mounting_colour_title": "Mounting colour",
  "mounting_letter_part_title": "Mounting Side",
  "mounting_support_exclusion_message": "The selected mounting option is not available with this backboard.",
  "mounting_title": "Mounting",
  "options_tab": "Options",
  "preview_note": "Colours may appear different in real life",
  "price": "",
  "price_after_label": "",
  "price_box_text": "Free shipping, One year guarantee",
  "price_button_add": "Add to Bag",
  "price_button_finish": "Finish",
  "product_title": "Custom Sign:",
  "product_type_title": "Letter Type",
  "qualities_header": "Good to know",
  "quote_button": "Finalize Quote",
  "recenter": "Recenter",
  "recenter_warning": "Click to reset position",
  "retry": "Try Again",
  "right_side": "Right",
  "rotation": "Rotation",
  "shape_finished_size": "Finished size: {width} × {height} {unit}",
  "shape_proportions_fixed_by": "Proportions fixed by {shape}",
  "shape_size_adjusted_to_fixed_proportions": "Your saved size was adjusted to match this shape’s fixed proportions.",
  "shape_size_adjusted_to_range": "Size adjusted to fit the available range.",
  "shape_sizing_empty_feasible_range": "This shape cannot be sized within the available minimum and maximum dimensions.",
  "shape_sizing_invalid_canonical_bounds": "This shape is unavailable because its proportions could not be loaded.",
  "shape_sizing_invalid_intent": "Enter a valid size to continue.",
  "shape_sizing_preset_requires_custom": "Choose a custom size for this shape.",
  "share_design": "Share my design",
  "share_design_modal_description": "",
  "share_design_modal_title": "Share Your Design",
  "show_background_preview": true,
  "show_contact_section": true,
  "show_custom_design": true,
  "show_custom_design_link": true,
  "show_inclusion_section": true,
  "show_preview_note": true,
  "show_review_images": true,
  "show_review_section": true,
  "show_styled_note": true,
  "show_text_editor_overlay": true,
  "sign_header": "YOUR SIGN",
  "size_title": "Size",
  "slider_button": "Switch back to slider",
  "summary_header": "YOUR SIGN DETAILS:",
  "support_colour_min_size_message": "The selected backboard colour is only available for larger sizes.",
  "support_colour_title": "Backboard Color",
  "support_title": "Backboard",
  "tap_word_mobile": "Tap on a word to begin customising it.",
  "text_align_center": "Center",
  "text_align_left": "Left",
  "text_align_right": "Right",
  "text_align_title": "Text Align",
  "text_button_label": "Got a text sign? Customise now",
  "text_label": "Write your text",
  "text_orientation_horizontal": "Horizontal",
  "text_orientation_title": "Orientation",
  "text_orientation_vertical_stacked": "Vertical",
  "text_title": "Text",
  "top_side": "Top",
  "upload_background": "Upload Background",
  "uploading_images": "Uploading Images",
  "user_bg_scale_cancel": "Cancel",
  "user_bg_scale_continue": "Continue",
  "user_bg_scale_description": "Specify the width and height this image represents in order to see your sign at a realistic scale.",
  "user_bg_scale_error": "Width and height must be numbers greater than 0.",
  "user_bg_scale_title": "Relative Scale",
  "visualiser_off": "Off",
  "visualiser_on": "On",
  "width_input": "Width",
  "zoom_in": "Zoom In",
  "zoom_out": "Zoom Out"
}
Update customiser labels
curl https://web.signcustomiser.com/api/v3/customisers/1/labels \
  --request PATCH \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "adding_to_cart": "Adding to Cart",
  "allow_custom_background": true,
  "apply_style": "Apply to all",
  "aspect_ratio_warning": "Values may be modified to maintain the required aspect ratio",
  "backboard_upload_error": "Maximum upload size 2mb",
  "backgrounds": "Backgrounds",
  "backlight_title": "Backlight",
  "border_included": "(includes {border} border)",
  "bottom_side": "Bottom",
  "braille_fixed_size_info_label": "Braille dots stay at their accessibility-standard size; larger sign sizes carry larger tactile lettering.",
  "braille_frame_too_small_message": "Choose a bigger sign size so the braille can fit at its fixed size.",
  "braille_overview_fitted_to_screen_label": "Overview — fitted to screen",
  "braille_translation_failed_message": "Braille translation could not refresh. Please try again.",
  "braille_translation_pending_message": "Translating to Braille…",
  "braille_untranslatable_modal_button_label": "Get a custom quote",
  "braille_untranslatable_modal_label": "Some of your text cannot be turned into braille automatically. Send us your design and we will quote it for you.",
  "cancel": "Cancel",
  "char_limit_reached": "You have exceeded the maximum number of characters for the current size.",
  "character_limit_message": "The maximum number of characters for this current size has been reached.",
  "character_text": "characters max per line for current size",
  "click_word_desktop": "Click on a word to begin customising it.",
  "cm_button": "Use cm",
  "colour_min_size_message": "The selected colour is only available for larger sizes.",
  "colour_title": "Color",
  "contact_description": "Feel free to reach out through our Live Chat, read through our FAQ page or send us an email.",
  "contact_header": "Have some questions? We'"'"'re here for you!",
  "copy_button": "Copy",
  "create_product_failed": "Something went wrong",
  "creating_product": "Creating Product",
  "crop_confirm": "Confirm",
  "crop_modal_title": "Resize your image",
  "crop_upload": "Upload your own image",
  "custom_design_button_label": "Got a logo? Get a quote",
  "custom_design_form_file_label": "Accepted file types include JPEG, PNG, SVG, PDF, AI and EPS.",
  "custom_design_form_input_error": "Invalid input.",
  "custom_design_form_message_error": "Form submission failed. Please try again.",
  "custom_design_form_message_success": "Thank you for your submission.",
  "custom_design_form_size_error": "File size cannot exceed 10MB.",
  "custom_design_form_submit_message": "Submitting form, please wait.",
  "custom_design_form_total_size_error": "Total file size cannot exceed 20MB.",
  "custom_design_steps_header": "How it works",
  "custom_design_tab_title": "Custom",
  "custom_design_type": "form",
  "custom_sizing_message": "Enter text to set a custom size",
  "default_text": "Start Typing",
  "display_initial_background_image": true,
  "display_initial_review_image": true,
  "edit_design": "Edit my design",
  "editing_word": "Editing",
  "etsy_button": "Continue to Etsy",
  "etsy_copied_button": "Copied",
  "etsy_copy_details_button": "Copy details",
  "etsy_customisation_summary_label": "Customisation summary",
  "etsy_download_preview_button": "Download preview",
  "etsy_listing_url_missing": "Your Etsy listing link hasn'"'"'t been set up yet. Contact the shop to get the link.",
  "etsy_preparing_image": "Preparing image",
  "etsy_preview_error": "Preview couldn'"'"'t be generated. Please try again.",
  "etsy_return_button": "Return To Etsy To Place An Order",
  "etsy_step1": "Copy your details",
  "etsy_step2": "Return to Etsy",
  "etsy_step3": "Paste into the personalisation box",
  "etsy_suggested_price_label": "Suggested price",
  "etsy_summary_colour_label": "Colour",
  "etsy_summary_description": "Copy these details into the personalisation box on Etsy, then add this item to your basket there.",
  "etsy_summary_design_label": "Design",
  "etsy_summary_face_colour_label": "Face",
  "etsy_summary_halo_colour_label": "Halo",
  "etsy_summary_icon_label": "Icon",
  "etsy_summary_line_label": "Line",
  "etsy_summary_no": "No",
  "etsy_summary_not_selected": "Not selected",
  "etsy_summary_side_colour_label": "Side",
  "etsy_summary_title": "Your Etsy order details",
  "etsy_summary_trim_colour_label": "Trim",
  "etsy_summary_tube_colour_label": "Tube",
  "etsy_summary_uploaded_design_label": "Uploaded design",
  "etsy_summary_yes": "Yes",
  "example": "Example",
  "extra_colour_exclusion_message": "The selected option is not available with this colour.",
  "extras_title": "Extras",
  "file_label": "Upload your logo",
  "file_upload_label": "Drop an image here or tap to browse",
  "font_title": "Font",
  "generating_image": "Generating Image",
  "header_text": "CREATE YOUR CUSTOM SIGN",
  "height_input": "Height",
  "icon_button_label": "Icons",
  "icon_title": "Icons",
  "inch_button": "Use inches",
  "inclusions": "Your Custom Sign\nPower Supply\nDigital Installation Guide\nFree Express Shipping\n12-Month Warranty",
  "inclusions_header": "What'"'"'s included in your custom sign?",
  "invalid_characters": "Text contains invalid characters: {characters}. Please try another font.",
  "jacket_colour_exclusion_message": "The selected jacket option is not available for this colour.",
  "jacket_title": "Jacket",
  "label_under_price": "",
  "left_side": "Left",
  "letter_parts_description": "",
  "letter_parts_title": "",
  "lightbox_product_type_title": "Lightbox",
  "line_limit_reached": "You have exceeded the maximum number of lines for the current size.",
  "lines_text": "lines",
  "loading_manual_clear_text": "Your design is being added to the cart. Please wait...",
  "logo_button_text": "Submit Custom Design",
  "logo_text": "To Submit a Custom Design, please click on the button below",
  "logo_upload_design_ready": "Design Ready!",
  "logo_upload_failed_description": "Fill out the form to send us an inquiry, we'"'"'ll automatically attach this image",
  "logo_upload_failed_title": "We couldn'"'"'t process your image",
  "logo_upload_file_too_large": "This file is too large. Choose a file up to {limit} MB.",
  "logo_upload_form_description": "We'"'"'ll keep processing your file and send the customisable version to your email when ready.",
  "logo_upload_form_email_placeholder": "Your email",
  "logo_upload_form_name_placeholder": "Your name",
  "logo_upload_form_submit_button": "Submit Request",
  "logo_upload_form_submitted_description": "We'"'"'ll process your image in the background and email you when it'"'"'s ready.",
  "logo_upload_form_submitted_title": "Request Submitted!",
  "logo_upload_form_title": "Taking longer than expected?",
  "logo_upload_pending_description": "Depending on the complexity of the image, this may take a few minutes.",
  "logo_upload_pending_title": "Processing your image",
  "logo_upload_try_another": "Try another image",
  "main_tab_title": "Text",
  "manual_button": "Enter dimensions manually",
  "material_mounting_exclusion_message": "The selected material is not available with this mounting option.",
  "material_support_exclusion_message": "The selected material is not available with this backboard.",
  "material_title": "Material",
  "max_sign_char": "characters max",
  "max_sign_modal_button_label": "Get a quote",
  "max_sign_modal_label": "Size is over the limit. Contact us for a quote.",
  "min_character_message": "or more characters are required for this size, please add more characters.",
  "min_height_sign_warning": "The overall sign height is too small. Please increase the height.",
  "mounting_colour_exclusion_message": "The selected mounting option is not available with this colour.",
  "mounting_colour_min_size_message": "This colour requires a larger sign size.",
  "mounting_colour_title": "Mounting colour",
  "mounting_letter_part_title": "Mounting Side",
  "mounting_support_exclusion_message": "The selected mounting option is not available with this backboard.",
  "mounting_title": "Mounting",
  "options_tab": "Options",
  "preview_note": "Colours may appear different in real life",
  "price": "",
  "price_after_label": "",
  "price_box_text": "Free shipping, One year guarantee",
  "price_button_add": "Add to Bag",
  "price_button_finish": "Finish",
  "product_title": "Custom Sign:",
  "product_type_title": "Letter Type",
  "qualities_header": "Good to know",
  "quote_button": "Finalize Quote",
  "recenter": "Recenter",
  "recenter_warning": "Click to reset position",
  "retry": "Try Again",
  "right_side": "Right",
  "rotation": "Rotation",
  "shape_finished_size": "Finished size: {width} × {height} {unit}",
  "shape_proportions_fixed_by": "Proportions fixed by {shape}",
  "shape_size_adjusted_to_fixed_proportions": "Your saved size was adjusted to match this shape’s fixed proportions.",
  "shape_size_adjusted_to_range": "Size adjusted to fit the available range.",
  "shape_sizing_empty_feasible_range": "This shape cannot be sized within the available minimum and maximum dimensions.",
  "shape_sizing_invalid_canonical_bounds": "This shape is unavailable because its proportions could not be loaded.",
  "shape_sizing_invalid_intent": "Enter a valid size to continue.",
  "shape_sizing_preset_requires_custom": "Choose a custom size for this shape.",
  "share_design": "Share my design",
  "share_design_modal_description": "",
  "share_design_modal_title": "Share Your Design",
  "show_background_preview": true,
  "show_contact_section": true,
  "show_custom_design": true,
  "show_custom_design_link": true,
  "show_inclusion_section": true,
  "show_preview_note": true,
  "show_review_images": true,
  "show_review_section": true,
  "show_styled_note": true,
  "show_text_editor_overlay": true,
  "sign_header": "YOUR SIGN",
  "size_title": "Size",
  "slider_button": "Switch back to slider",
  "summary_header": "YOUR SIGN DETAILS:",
  "support_colour_min_size_message": "The selected backboard colour is only available for larger sizes.",
  "support_colour_title": "Backboard Color",
  "support_title": "Backboard",
  "tap_word_mobile": "Tap on a word to begin customising it.",
  "text_align_center": "Center",
  "text_align_left": "Left",
  "text_align_right": "Right",
  "text_align_title": "Text Align",
  "text_button_label": "Got a text sign? Customise now",
  "text_label": "Write your text",
  "text_orientation_horizontal": "Horizontal",
  "text_orientation_title": "Orientation",
  "text_orientation_vertical_stacked": "Vertical",
  "text_title": "Text",
  "top_side": "Top",
  "upload_background": "Upload Background",
  "uploading_images": "Uploading Images",
  "user_bg_scale_cancel": "Cancel",
  "user_bg_scale_continue": "Continue",
  "user_bg_scale_description": "Specify the width and height this image represents in order to see your sign at a realistic scale.",
  "user_bg_scale_error": "Width and height must be numbers greater than 0.",
  "user_bg_scale_title": "Relative Scale",
  "visualiser_off": "Off",
  "visualiser_on": "On",
  "width_input": "Width",
  "zoom_in": "Zoom In",
  "zoom_out": "Zoom Out"
}'
Response
{
  "data": {
    "object": "customiser_labels",
    "customiser_id": 42,
    "adding_to_cart": "Adding to Cart",
    "allow_custom_background": true,
    "apply_style": "Apply to all",
    "aspect_ratio_warning": "Values may be modified to maintain the required aspect ratio",
    "backboard_upload_error": "Maximum upload size 2mb",
    "backgrounds": "Backgrounds",
    "backlight_title": "Backlight",
    "border_included": "(includes {border} border)",
    "bottom_side": "Bottom",
    "braille_fixed_size_info_label": "Braille dots stay at their accessibility-standard size; larger sign sizes carry larger tactile lettering.",
    "braille_frame_too_small_message": "Choose a bigger sign size so the braille can fit at its fixed size.",
    "braille_overview_fitted_to_screen_label": "Overview — fitted to screen",
    "braille_translation_failed_message": "Braille translation could not refresh. Please try again.",
    "braille_translation_pending_message": "Translating to Braille…",
    "braille_untranslatable_modal_button_label": "Get a custom quote",
    "braille_untranslatable_modal_label": "Some of your text cannot be turned into braille automatically. Send us your design and we will quote it for you.",
    "cancel": "Cancel",
    "char_limit_reached": "You have exceeded the maximum number of characters for the current size.",
    "character_limit_message": "The maximum number of characters for this current size has been reached.",
    "character_text": "characters max per line for current size",
    "click_word_desktop": "Click on a word to begin customising it.",
    "cm_button": "Use cm",
    "colour_min_size_message": "The selected colour is only available for larger sizes.",
    "colour_title": "Color",
    "contact_description": "Feel free to reach out through our Live Chat, read through our FAQ page or send us an email.",
    "contact_header": "Have some questions? We're here for you!",
    "copy_button": "Copy",
    "create_product_failed": "Something went wrong",
    "creating_product": "Creating Product",
    "crop_confirm": "Confirm",
    "crop_modal_title": "Resize your image",
    "crop_upload": "Upload your own image",
    "custom_design_button_label": "Got a logo? Get a quote",
    "custom_design_form_file_label": "Accepted file types include JPEG, PNG, SVG, PDF, AI and EPS.",
    "custom_design_form_input_error": "Invalid input.",
    "custom_design_form_message_error": "Form submission failed. Please try again.",
    "custom_design_form_message_success": "Thank you for your submission.",
    "custom_design_form_size_error": "File size cannot exceed 10MB.",
    "custom_design_form_submit_message": "Submitting form, please wait.",
    "custom_design_form_total_size_error": "Total file size cannot exceed 20MB.",
    "custom_design_link": null,
    "custom_design_steps": [
      {
        "header": "How it works",
        "description": "Send us your artwork."
      }
    ],
    "custom_design_steps_header": "How it works",
    "custom_design_tab_title": "Custom",
    "custom_design_type": "form",
    "custom_form_header": null,
    "custom_sizing_message": "Enter text to set a custom size",
    "default_text": "Start Typing",
    "display_initial_background_image": true,
    "display_initial_review_image": true,
    "edit_design": "Edit my design",
    "editing_word": "Editing",
    "etsy_button": "Continue to Etsy",
    "etsy_copied_button": "Copied",
    "etsy_copy_details_button": "Copy details",
    "etsy_customisation_summary_label": "Customisation summary",
    "etsy_download_preview_button": "Download preview",
    "etsy_listing_url_missing": "Your Etsy listing link hasn't been set up yet. Contact the shop to get the link.",
    "etsy_preparing_image": "Preparing image",
    "etsy_preview_error": "Preview couldn't be generated. Please try again.",
    "etsy_return_button": "Return To Etsy To Place An Order",
    "etsy_step1": "Copy your details",
    "etsy_step2": "Return to Etsy",
    "etsy_step3": "Paste into the personalisation box",
    "etsy_suggested_price_label": "Suggested price",
    "etsy_summary_colour_label": "Colour",
    "etsy_summary_description": "Copy these details into the personalisation box on Etsy, then add this item to your basket there.",
    "etsy_summary_design_label": "Design",
    "etsy_summary_face_colour_label": "Face",
    "etsy_summary_halo_colour_label": "Halo",
    "etsy_summary_icon_label": "Icon",
    "etsy_summary_line_label": "Line",
    "etsy_summary_no": "No",
    "etsy_summary_not_selected": "Not selected",
    "etsy_summary_side_colour_label": "Side",
    "etsy_summary_title": "Your Etsy order details",
    "etsy_summary_trim_colour_label": "Trim",
    "etsy_summary_tube_colour_label": "Tube",
    "etsy_summary_uploaded_design_label": "Uploaded design",
    "etsy_summary_yes": "Yes",
    "example": "Example",
    "extra_colour_exclusion_message": "The selected option is not available with this colour.",
    "extras_title": "Extras",
    "file_label": "Upload your logo",
    "file_upload_label": "Drop an image here or tap to browse",
    "font_title": "Font",
    "generating_image": "Generating Image",
    "header_text": "CREATE YOUR CUSTOM SIGN",
    "height_input": "Height",
    "highlights": [
      "Handmade",
      "12-month warranty",
      "Free shipping"
    ],
    "icon_button_label": "Icons",
    "icon_title": "Icons",
    "inch_button": "Use inches",
    "inclusions": "Your Custom Sign\nPower Supply\nDigital Installation Guide\nFree Express Shipping\n12-Month Warranty",
    "inclusions_header": "What's included in your custom sign?",
    "invalid_characters": "Text contains invalid characters: {characters}. Please try another font.",
    "jacket_colour_exclusion_message": "The selected jacket option is not available for this colour.",
    "jacket_title": "Jacket",
    "label_under_price": "",
    "left_side": "Left",
    "letter_parts_description": "",
    "letter_parts_title": "",
    "lightbox_product_type_title": "Lightbox",
    "line_limit_reached": "You have exceeded the maximum number of lines for the current size.",
    "lines_text": "lines",
    "loading_manual_clear_text": "Your design is being added to the cart. Please wait...",
    "logo_button_text": "Submit Custom Design",
    "logo_text": "To Submit a Custom Design, please click on the button below",
    "logo_upload_design_ready": "Design Ready!",
    "logo_upload_failed_description": "Fill out the form to send us an inquiry, we'll automatically attach this image",
    "logo_upload_failed_title": "We couldn't process your image",
    "logo_upload_file_too_large": "This file is too large. Choose a file up to {limit} MB.",
    "logo_upload_form_description": "We'll keep processing your file and send the customisable version to your email when ready.",
    "logo_upload_form_email_placeholder": "Your email",
    "logo_upload_form_name_placeholder": "Your name",
    "logo_upload_form_submit_button": "Submit Request",
    "logo_upload_form_submitted_description": "We'll process your image in the background and email you when it's ready.",
    "logo_upload_form_submitted_title": "Request Submitted!",
    "logo_upload_form_title": "Taking longer than expected?",
    "logo_upload_pending_description": "Depending on the complexity of the image, this may take a few minutes.",
    "logo_upload_pending_title": "Processing your image",
    "logo_upload_try_another": "Try another image",
    "main_tab_title": "Text",
    "manual_button": "Enter dimensions manually",
    "material_mounting_exclusion_message": "The selected material is not available with this mounting option.",
    "material_support_exclusion_message": "The selected material is not available with this backboard.",
    "material_title": "Material",
    "max_sign_char": "characters max",
    "max_sign_modal_button_label": "Get a quote",
    "max_sign_modal_button_link": null,
    "max_sign_modal_label": "Size is over the limit. Contact us for a quote.",
    "min_character_message": "or more characters are required for this size, please add more characters.",
    "min_height_sign_warning": "The overall sign height is too small. Please increase the height.",
    "mounting_colour_exclusion_message": "The selected mounting option is not available with this colour.",
    "mounting_colour_min_size_message": "This colour requires a larger sign size.",
    "mounting_colour_title": "Mounting colour",
    "mounting_letter_part_title": "Mounting Side",
    "mounting_support_exclusion_message": "The selected mounting option is not available with this backboard.",
    "mounting_title": "Mounting",
    "options_tab": "Options",
    "preview_note": "Colours may appear different in real life",
    "price": "",
    "price_after_label": "",
    "price_box_text": "Free shipping, One year guarantee",
    "price_button_add": "Add to Bag",
    "price_button_finish": "Finish",
    "product_title": "Custom Sign:",
    "product_type_title": "Letter Type",
    "qualities": [
      {
        "header": "How it works",
        "description": "Send us your artwork."
      }
    ],
    "qualities_header": "Good to know",
    "quote_button": "Finalize Quote",
    "recenter": "Recenter",
    "recenter_warning": "Click to reset position",
    "retry": "Try Again",
    "right_side": "Right",
    "rotation": "Rotation",
    "shape_finished_size": "Finished size: {width} × {height} {unit}",
    "shape_proportions_fixed_by": "Proportions fixed by {shape}",
    "shape_size_adjusted_to_fixed_proportions": "Your saved size was adjusted to match this shape’s fixed proportions.",
    "shape_size_adjusted_to_range": "Size adjusted to fit the available range.",
    "shape_sizing_empty_feasible_range": "This shape cannot be sized within the available minimum and maximum dimensions.",
    "shape_sizing_invalid_canonical_bounds": "This shape is unavailable because its proportions could not be loaded.",
    "shape_sizing_invalid_intent": "Enter a valid size to continue.",
    "shape_sizing_preset_requires_custom": "Choose a custom size for this shape.",
    "share_design": "Share my design",
    "share_design_modal_description": "",
    "share_design_modal_title": "Share Your Design",
    "show_background_preview": true,
    "show_contact_section": true,
    "show_custom_design": true,
    "show_custom_design_link": true,
    "show_inclusion_section": true,
    "show_preview_note": true,
    "show_review_images": true,
    "show_review_section": true,
    "show_styled_note": true,
    "show_text_editor_overlay": true,
    "sign_header": "YOUR SIGN",
    "size_title": "Size",
    "slider_button": "Switch back to slider",
    "summary_header": "YOUR SIGN DETAILS:",
    "support_colour_min_size_message": "The selected backboard colour is only available for larger sizes.",
    "support_colour_title": "Backboard Color",
    "support_title": "Backboard",
    "tap_word_mobile": "Tap on a word to begin customising it.",
    "text_align_center": "Center",
    "text_align_left": "Left",
    "text_align_right": "Right",
    "text_align_title": "Text Align",
    "text_button_label": "Got a text sign? Customise now",
    "text_label": "Write your text",
    "text_orientation_horizontal": "Horizontal",
    "text_orientation_title": "Orientation",
    "text_orientation_vertical_stacked": "Vertical",
    "text_title": "Text",
    "top_side": "Top",
    "upload_background": "Upload Background",
    "uploading_images": "Uploading Images",
    "user_bg_scale_cancel": "Cancel",
    "user_bg_scale_continue": "Continue",
    "user_bg_scale_description": "Specify the width and height this image represents in order to see your sign at a realistic scale.",
    "user_bg_scale_error": "Width and height must be numbers greater than 0.",
    "user_bg_scale_title": "Relative Scale",
    "visualiser_off": "Off",
    "visualiser_on": "On",
    "width_input": "Width",
    "zoom_in": "Zoom In",
    "zoom_out": "Zoom Out",
    "additional_information": [
      {
        "header": "Free express shipping",
        "description": "Every sign ships free, worldwide.",
        "image_url": "https://cdn.signcustomiser.com/labels/shipping.png"
      }
    ],
    "background_images": [
      {
        "name": "brick-wall.jpg",
        "image_url": "https://cdn.signcustomiser.com/labels/brick-wall.jpg",
        "width_cm": 152.4,
        "height_cm": 101.6
      }
    ],
    "product_image_url": "https://cdn.signcustomiser.com/labels/product.png",
    "updated_at": "2026-05-04T09:12:31Z"
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/customisers/42/labels",
    "documentation": "https://www.signcustomiser.com/help/api/"
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}