# Forms

## Update custom messages

### PUT

`https://api.typeform.com/forms/{form_id}/messages`

Specifies new values for the customizable messages in a form (specified by `form_id`).

You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

## Request

### Path Parameters

- **form_id**, required  
  Unique ID for the form. Find in your form URL. For example, in the URL "https://mysite.typeform.com/to/u6nXL7" the form_id is `u6nXL7`.

### Request Body

- **label.buttonHint.default**  
  `string`  
  Default tooltip button message. Maximum 28 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.buttonHint.longtext**  
  `string`  
  Tooltip button message for long text blocks. Maximum 28 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.warning.connection**  
  `string`  
  Server connection error message. Maximum 128 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.buttonNoAnswer.default**  
  `string`  
  Default continue button message. Maximum 100 characters.

- **label.warning.correction**  
  `string`  
  List of errors message. Maximum 128 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.payment.cardNameTitle**  
  `string`  
  Credit card name message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.payment.cardNumberTitle**  
  `string`  
  Credit card number message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.payment.cvcDescription**  
  `string`  
  Credit card security number message.

- **block.payment.cvcNumberTitle**  
  `string`  
  Credit card CVC number message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.shortText.placeholder**  
  `string`  
  Text input placeholder. Maximum 100 characters.

- **label.error.emailAddress**  
  `string`  
  Invalid email error message. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.expiryMonthTitle**  
  `string`  
  Credit card expiry month message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.expiryYearTitle**  
  `string`  
  Credit card expiry year message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.warning.fallbackAlert**  
  `string`  
  Fallback alert message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.fileUpload.choose**  
  `string`  
  File upload button message. Maximum 34 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.fileUpload.drag**  
  `string`  
  File upload dragging action message. Maximum 35 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.fileUpload.uploadingProgress**  
  `string`  
  Still processing file upload message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.sizeLimit**  
  `string`  
  File too big error message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.warning.formUnavailable**  
  `string`  
  Private form error message. Accepts variable `form:name`. Maximum 128 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.incompleteForm**  
  `string`  
  Incomplete fields error message. Maximum 42 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.hint.key**  
  `string`  
  Key letter hint message. Maximum 100 characters.

- **block.legal.reject**  
  `string`  
  Legal field deny message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.legal.accept**  
  `string`  
  Legal field accept message. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.maxValue**  
  `string`  
  Number maximum value tooltip message. Accepts variable `field:max`. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.maxLength**  
  `string`  
  Text fields maximum length tooltip message. Accepts variable `field:max_length`. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.minValue**  
  `string`  
  Number minimum value tooltip message. Accepts variable `field:min`. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.range**  
  `string`  
  Number minimum and maximum range value tooltip message. Accepts variables `field:min` and `field:max`. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.multipleChoice.hint**  
  `string`  
  Choose as many as you like message for multiple choice fields. Maximum 45 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.mustEnter**  
  `string`  
  Required value error message. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.error.mustSelect**  
  `string`  
  Required selection error message. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.no.shortcut**  
  `string`  
  Keyboard shortcut for the "No" option. Maximum 1 character.

- **label.no.default**  
  `string`  
  Representation for the word "No." You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.dropdown.hint**  
  `string`  
  Not suggestions found for dropdown fields error message. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.multipleChoice.other**  
  `string`  
  Other answer message. Maximum 100 characters.

- **label.progress.percent**  
  `string`  
  Completion percentage message. Accepts variable `progress:percent`. Maximum 100 characters.

- **label.progress.proportion**  
  `string`  
  Completion proportion message. Accepts variables `progress:step` and `progress:total`. Maximum 100 characters.

- **label.error.required**  
  `string`  
  Required field error message. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.preview**  
  `string`  
  Review fields error message. Accepts variable `form:unanswered_fields`. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.button.review**  
  `string`  
  Review button message. Maximum 100 characters.

- **label.error.server**  
  `string`  
  Server error message. Maximum 128 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.action.share**  
  `string`  
  Share text message. Maximum 100 characters.

- **label.button.submit**  
  `string`  
  Submit button message. Maximum 100 characters.

- **label.warning.success**  
  `string`  
  Successful submit message. Maximum 128 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.button.ok**  
  `string`  
  Answer confirm. Maximum 100 characters.

- **label.error.mustAccept**  
  `string`  
  Legal field terms and conditions message. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.longtext.hint**  
  `string`  
  Long text field tooltip message. Maximum 128 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **block.dropdown.placeholder**  
  `string`  
  Placeholder message with instructions for dropdown fields. Maximum 100 characters.

- **block.dropdown.placeholderTouch**  
  `string`  
  Placeholder message with instructions for dropdown fields on touch devices. Maximum 100 characters.

- **label.error.url**  
  `string`  
  Invalid URL error message. Maximum 64 characters. You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

- **label.yes.shortcut**  
  `string`  
  Keyboard shortcut for the "Yes" option. Maximum 1 character.

- **label.yes.default**  
  `string`  
  Representation for the word "Yes". You can format messages with bold (`*bold*`) and italic (`_italic_`) text. HTML tags are forbidden.

## Response

### Status

**204 OK**