Placeholders insert email and account data into your prompts. Use the defaults below, or add your own custom data placeholders.
Default placeholders
Account & Folder 3
- ReadingCompose Account & Folder
since v3.3.0
The mail address of the current account.
- Reading Account & Folder
since v3.3.0
The folder name containing the email.
- Reading Account & Folder
since v3.3.0
The complete path of the folder containing the email.
Email Content 11
- Reading Email Content
since v3.7.0
Prints a list of information about the attachments of the email, in the form
"file name" [file type] (file size). As an example:"google.png" [image/png] (2 KB). - ReadingCompose Email Content
since v4.0.0
A selection if there is any, otherwise the body of the email in HTML.
- ReadingCompose Email Content
The body of the email in HTML.
- Reading Email Content
since v5.0.0
The original plain text part of the email, exactly as the sender wrote it, with no conversion from the HTML part. Blank lines and column alignment are preserved, so it is well suited to business mail, invoices and automated notifications, and it usually costs fewer tokens than {%mail_text_body%}. It is empty when the email has no plain text part, and some newsletters only include a stub there.
- Compose Email Content
since v3.4.0
This placeholders autoselects the quoted text only when is after the reply text, removing any previous manual made selection.
- ReadingCompose Email Content
The subject of the email.
- ReadingCompose Email Content
since v4.0.0
A selection if there is any, otherwise the body of the email in plain text.
- ReadingCompose Email Content
The body of the email in plain text.
- Compose Email Content
since v3.1.0
This placeholders autoselects the text typed in a message only when it's before the quoted email, removing any previous manual made selection.
- ReadingCompose Email Content
since v3.5.0
The html part of the text selected by the user. To use this placeholder the "Text selection needed" flag must be set in the prompt configuration.
- ReadingCompose Email Content
The text selected by the user. To use this placeholder the "Text selection needed" flag must be set in the prompt configuration.
Email Metadata 7
- ReadingCompose Email Metadata
The author of the email.
- ReadingCompose Email Metadata
The list of addresses of the CC field of the email, separated by a comma. When composing, the addresses typed in the Cc field are used.
- Reading Email Metadata
The Junk score of the email, only for received emails.
- Reading Email Metadata
since v3.1.0
The date and time of the email.
- Reading Email Metadata
since v4.1.0
Use this placeholder to get all the mail headers.
- Reading Email Metadata
since v3.8.0
Use this placeholder to get the value of any mail header, replacing <Header-ID> with the ID of the header you wish to retrieve. For example, use {%mail_headers:Received-SPF%} to use the value of Received-SPF. Spaces around the colon are ignored.
- ReadingCompose Email Metadata
The list of recipients of the email, separated by a comma. When composing, the addresses typed in the To field are used.
General 2
- ReadingCompose General
since v3.1.0
The current date and time.
- ReadingCompose General
since v3.4.0
This placeholder is always replaced by an empty string. This allows you to use a prompt that doesn't include any information from the email and prevents the email body from being automatically appended at the end.
Tags 2
- ReadingCompose Tags
since v3.0.0
A comma separated list of the tags of the current email.
- ReadingCompose Tags
since v3.0.0
A comma separated list of all the tags available in Thunderbird.
ThunderAI Settings 4
- ReadingCompose ThunderAI Settings
since v3.2.0
The default language as defined in the ThunderAI options page.
- ReadingCompose ThunderAI Settings
since v3.2.0
The default signature as defined in the ThunderAI options page.
- ReadingCompose ThunderAI Settings
since v4.1.0
The languages to be excluded from the translation as defined in the translation settings.
- ReadingCompose ThunderAI Settings
since v4.1.0
The language defined in the translation settings. If it is empty, the default language defined in the ThunderAI options page is used.
User Input 1
- ReadingCompose User Input
since v4.0.0
The text added by the user before sending the prompt. To use this placeholder the "Ask for additional text" flag must be set in the prompt configuration. You can define more instances of this placeholder, defining different <Placeholder-ID>, that will be shown in the form used to ask the value to the user. A field left empty is replaced by an empty text. This placeholder is not available in the "Add tags" and "Add Calendar Event" special prompts.
No placeholders match your search.
Adding and using placeholders
Custom placeholders can be added opening the dedicated tab, pressing the button
that can find in the ThunderAI options page.
Placeholders can be added using an autocomplete feature when writing a prompt on the custom prompts page.

With the option "Placeholders: Use default value", you can choose whether to use the default value or retain the placeholder when no value is available (for example, an email with no address in the CC field)
A custom placeholder that is disabled in the Data Placeholders page is not replaced in the prompts: it is left as written, as for a placeholder that does not exist.