Skip to content
Translations

Key Reference ​

Every key the built-in components use, grouped by component. Copy the ones you need into setTranslations().

The full list, generated from defaultTranslations (130 keys). Every key is optional: anything you don't set shows the English default. Params are the tokens the component passes in.

Actions ​

Generic button text. Several are reserved: no built-in component renders them, so they are there for your own components and stay consistent with the rest of the form.

KeyDefaultWhere it showsParams
action_addAddReserved: not used by a built-in component. For your own components.—
action_cancelCancelReserved: not used by a built-in component. For your own components.—
action_clearClearDate Picker and Time Picker: Clear button in the popover footer—
action_clear_fieldClear :labelScreen reader label of the × clear button on Text Input, Combobox, Date Picker, Time Picker and Color Picker (clearable()):label field label
action_closeCloseReserved: not used by a built-in component. For your own components.—
action_copyCopyReserved: not used by a built-in component. For your own components.—
action_copiedCopiedColor Picker: copy button label right after copying—
action_deleteDeleteReserved: not used by a built-in component. For your own components.—
action_delete_fieldDelete :nameBlocks, Repeater and Key Value: delete button label of an item or row:name item name, like Section 2 or row 3
action_doneDoneReserved: not used by a built-in component. For your own components.—
action_removeRemoveFile Upload: Remove button on each selected file—

Form ​

KeyDefaultWhere it showsParams
form_submitSubmitThe submit button <Form> adds when the form has no Submit or Composer field (also the last wizard step)—

Textarea ​

The counter key starts with form_ because Composer uses it too.

KeyDefaultWhere it showsParams
form_character_count:count / :maxTextarea counter with maxLength() (with showCharacterCount() and no max, only the number shows); Composer counter:count characters typed, :max

Select and Combobox ​

KeyDefaultWhere it showsParams
option_placeholderSelect an optionCombobox placeholder when nothing is picked, for fields that are not searchable() and have no placeholder()—
option_searchSearch…Combobox placeholder when nothing is picked, for searchable() fields without placeholder()—
option_searchingSearching…Combobox list text while a server search (searchUsing()) loads—
option_no_resultsNo resultsCombobox list text when nothing matches—
option_selected_count:count selectedCombobox multiple(): screen reader text in the trigger:count
option_removeRemove :nameCombobox multiple(): label of the × on each chip:name option label

File Upload and file sizes ​

The hint under the drop zone is built from these keys, joined with ·, like PDF, DOCX · up to 2.0 MB · max 3 files. File type names come from accept() and are not translated.

KeyDefaultWhere it showsParams
file_upload_click_to_uploadClick to uploadFile Upload: the highlighted link in the drop zone title. Rendered in the :action slot of file_upload_drop_prompt—
file_upload_drop_prompt:action or drag and dropFile Upload: drop zone title when the field has no placeholder():action slot (the link)
file_upload_imagesImagesFile Upload hint for image() fields without accept()—
file_upload_max_sizeup to :sizeFile Upload hint with maxSize():size formatted size, like 2.0 MB
file_upload_max_filesmax :count filesFile Upload hint with multiple() and maxFiles():count
file_size_bytes:size BSizes under 1 KB: File Upload file list, Composer attachments, the max size hint:size number
file_size_kb:size KBSizes under 1 MB (same places):size whole number
file_size_mb:size MBSizes of 1 MB and more (same places):size text with one decimal, like 2.5

Date Picker ​

KeyDefaultWhere it showsParams
date_placeholderSelect a dateDate Picker trigger text when empty—
date_range_placeholderSelect datesDate Picker range() trigger text when empty—
date_todayTodayDate Picker: Today button in the popover footer—
date_range:start – :endDate Picker range() trigger text. :end is … until the second date is picked:start, :end (each built with date_display)
date_display:month :day, :yearDate Picker trigger text of a picked date, like Oct 4, 2026:month short month name, :day, :year
date_time:date, :timeDate Picker withTime() trigger text:date (from date_display), :time (HH:MM)

Calendar ​

The calendar inside the Date Picker. Month and weekday names come from these keys, not from Intl, so the calendar shows exactly the words you set.

KeyDefaultWhere it showsParams
calendar_previous_yearPrevious yearCalendar navigation button label (screen readers)—
calendar_previous_monthPrevious monthCalendar navigation button label (screen readers)—
calendar_next_monthNext monthCalendar navigation button label (screen readers)—
calendar_next_yearNext yearCalendar navigation button label (screen readers)—
calendar_month_year:month :yearCalendar title above each month:month full month name, :year
calendar_day_label:weekday, :month :day, :yearLabel of each day button (screen readers):weekday, :month (full names), :day, :year
calendar_month_januaryJanuaryCalendar title and day labels—
calendar_month_februaryFebruaryCalendar title and day labels—
calendar_month_marchMarchCalendar title and day labels—
calendar_month_aprilAprilCalendar title and day labels—
calendar_month_mayMayCalendar title and day labels—
calendar_month_juneJuneCalendar title and day labels—
calendar_month_julyJulyCalendar title and day labels—
calendar_month_augustAugustCalendar title and day labels—
calendar_month_septemberSeptemberCalendar title and day labels—
calendar_month_octoberOctoberCalendar title and day labels—
calendar_month_novemberNovemberCalendar title and day labels—
calendar_month_decemberDecemberCalendar title and day labels—
calendar_month_short_januaryJanDate Picker trigger text (:month in date_display)—
calendar_month_short_februaryFebDate Picker trigger text (:month in date_display)—
calendar_month_short_marchMarDate Picker trigger text (:month in date_display)—
calendar_month_short_aprilAprDate Picker trigger text (:month in date_display)—
calendar_month_short_mayMayDate Picker trigger text (:month in date_display)—
calendar_month_short_juneJunDate Picker trigger text (:month in date_display)—
calendar_month_short_julyJulDate Picker trigger text (:month in date_display)—
calendar_month_short_augustAugDate Picker trigger text (:month in date_display)—
calendar_month_short_septemberSepDate Picker trigger text (:month in date_display)—
calendar_month_short_octoberOctDate Picker trigger text (:month in date_display)—
calendar_month_short_novemberNovDate Picker trigger text (:month in date_display)—
calendar_month_short_decemberDecDate Picker trigger text (:month in date_display)—
calendar_weekday_sundaySundayDay labels (screen readers)—
calendar_weekday_mondayMondayDay labels (screen readers)—
calendar_weekday_tuesdayTuesdayDay labels (screen readers)—
calendar_weekday_wednesdayWednesdayDay labels (screen readers)—
calendar_weekday_thursdayThursdayDay labels (screen readers)—
calendar_weekday_fridayFridayDay labels (screen readers)—
calendar_weekday_saturdaySaturdayDay labels (screen readers)—
calendar_weekday_short_sundaySuCalendar column headings—
calendar_weekday_short_mondayMoCalendar column headings—
calendar_weekday_short_tuesdayTuCalendar column headings—
calendar_weekday_short_wednesdayWeCalendar column headings—
calendar_weekday_short_thursdayThCalendar column headings—
calendar_weekday_short_fridayFrCalendar column headings—
calendar_weekday_short_saturdaySaCalendar column headings—

Time Picker ​

KeyDefaultWhere it showsParams
time_nowNowTime Picker: Now button in the popover footer—
time_hourHourHour column heading (Time Picker and Date Picker withTime())—
time_minuteMinMinute column heading—
time_secondSecSeconds column heading (withSeconds())—

Color Picker ​

KeyDefaultWhere it showsParams
color_placeholderPick a colorColor Picker trigger text when empty and no placeholder()—
color_hueHueColor Picker slider label—
color_saturationSaturationColor Picker slider label—
color_lightnessLightnessColor Picker slider label—
color_hex_code:label hex codeColor Picker hex input label (screen readers):label field label
color_eyedropperPick a color from the screenColor Picker eyedropper button label (in browsers that support it)—
color_copy_hexCopy hex codeColor Picker copy button label—

Tags Input ​

KeyDefaultWhere it showsParams
tags_placeholderType and press EnterTags Input placeholder when there are no tags and no placeholder()—
tags_list:label tagsTags Input chip list label (screen readers):label field label
tags_suggestions:label suggestionsTags Input suggestions list label (screen readers):label field label
tags_removeRemove :nameTags Input: label of the × on each chip:name tag text

Key Value ​

KeyDefaultWhere it showsParams
key_value_keyKeyKey column heading when PHP keyLabel() is not set—
key_value_valueValueValue column heading when PHP valueLabel() is not set—
key_value_addAdd rowAdd button when PHP addActionLabel() is not set—
key_value_emptyNo entries yet.Key Value empty state—
key_value_cell:label :numberKey and value input labels (screen readers):label column heading, :number row number
key_value_rowrow :numberRow name used as :name in the move and delete labels:number row number

Repeater and Blocks ​

Repeater and Blocks share one component, so the collection_* keys apply to both (and the move labels to Key Value too).

KeyDefaultWhere it showsParams
collection_expand_allExpand allToggle-all button when every item is collapsed (collapsible())—
collection_collapse_allCollapse allToggle-all button (collapsible())—
collection_move_upMove :name upMove up button label (Repeater, Blocks, Key Value):name item name
collection_move_downMove :name downMove down button label (Repeater, Blocks, Key Value):name item name
collection_item:label :numberItem title when titleFrom() is empty, and the item name in move and delete labels:label block or item label, :number
blocks_addAdd blockBlocks add button and add menu label when PHP addActionLabel() is not set—
blocks_emptyNo blocks yet.Blocks empty state—
repeater_addAdd :nameRepeater add button when PHP addActionLabel() is not set:name item label, lower-cased (itemLabel(), else the PHP key fields.repeater.item)
repeater_emptyNo items yet.Repeater empty state—
KeyDefaultWhere it showsParams
link_url_placeholderhttps://example.comLink URL input placeholder when no placeholder()—
link_text_placeholderLink textLink text input placeholder (withLabel() without a placeholder argument)—
link_text_label:label textLink text input label (screen readers):label field label
link_target_labelOpen :label inLink target choice label (screen readers, withTarget()):label field label
link_same_tabSame tabLink target option (withTarget())—
link_new_tabNew tabLink target option (withTarget())—
link_scheme_hintStart with :schemeHint under the Link input with requireScheme():scheme, like https://

Slug ​

KeyDefaultWhere it showsParams
slug_regenerateRegenerate :labelSlug regenerate button label and tooltip:label field label

OTP Input ​

KeyDefaultWhere it showsParams
otp_digitDigit :number of :totalLabel of each box (screen readers), numeric codes:number, :total
otp_characterCharacter :number of :totalLabel of each box (screen readers), alphanumeric() codes:number, :total

Composer ​

KeyDefaultWhere it showsParams
composer_sendSendSend button when PHP sendLabel() is not set—
composer_attachAttach filesPaperclip button label and tooltip (attachments())—
composer_attachmentsAttachmentsAttachment list label (screen readers)—
composer_quick_repliesQuick repliesQuick replies group label (screen readers)—
composer_remove_attachmentRemove :nameLabel of the × on each attachment:name file name
composer_hintPress :enter to send, :newline for new lineHint under the box with submitOnEnter(). Each slot is rendered as a <kbd>:enter, :newline slots
composer_key_enterEnterKey name in the :enter slot of composer_hint—
composer_key_newlineShift + EnterKey name in the :newline slot of composer_hint—

Wizard ​

KeyDefaultWhere it showsParams
wizard_nextContinueWizard Continue button when PHP wizard(nextLabel: ...) is not set—
wizard_backBackWizard Back button when PHP wizard(backLabel: ...) is not set—
wizard_progressStep :current of :totalCompact step counter above the progress bar:current (starts at 1), :total
wizard_progress_labelProgressLabel of the steps navigation (screen readers)—
wizard_stepStep :numberTitle of a step whose fieldset has no legend:number (starts at 1)