Skip to content

List of all supported tags

Samuel Plentz edited this page Aug 17, 2023 · 36 revisions

Table of Contents

ATT CLIPBOARD COUNTER
CURSOR DATE FILE
FROM HEADER IMAGE
INPUT ORGATT ORGHEADER
SCRIPT SELECTION SUBJECT
TEXT TIME TO
URL VERSION

ATT

[[ATT=type|separator]]

Return the filename of each attachment and optional also its size.

type [optional] A type of name (default) just returns the name and full also returns the file size of each attachment. The type modified returns the last modified date of each attachment as unix epoch timestamp. (see #352)
separator [optional] If there are several attachments, this string is used for separating them. Default is ", ". Other examples are "\n" or ",\n".

Examples:

[[ATT]] [[ATT=full]]


CLIPBOARD

[[CLIPBOARD]]

Gets the current clipboard.


COUNTER

[[COUNTER]]

Returns a counter that increase every time it gets inserted. Could be used to get unique numbers. It will return the same number, if used multiple times within the same template.


CURSOR

[[CURSOR]]

Place the cursor at this location after inserting template.


DATE

[[DATE=type]]

Gets the current date.

type optional The type may be short (default), long or monthname. The actually inserted value depends on the language of your OS.

Examples:

[[DATE]] [[DATE=long]]


FILE

[[FILE=path|options]]

Gets the content of a local plain text file (UTF8 encoded). For remote files use URL and if you want a file to be added as an attachment use the attachment field in the Quicktext settings window.

path [required] The path to the local file.
options [optional] Comma separated list of options. Supported options:
  • strip_html_comments - Remove HTML comments from file before inserting it
  • force_as_text - Insert file as plain text in HTML composer (v6.*)

Examples:

[[FILE=C:\file.txt]]


FROM

[[FROM=type]]

Gets the value from the from-field. First it tries to get the value from the address book. If that is not possible, it tries to parse the mail address.

type [required] The type may be email, firstname, lastname, fullname, displayname, nickname, ...

A full list of all allowed attributes can be found here.

Examples:

[[FROM=firstname]] [[FROM=fullname]]


HEADER

[[HEADER=name|value]]

Adds a header to the mail. Currently supported are

  • to
  • cc
  • bcc
  • reply-to

Examples:

[[HEADER=bcc|user@inter.net]]


IMAGE

[[IMAGE=path|type]]

Gets the content of a local image file and places it inline into the email. Can only be used in HTML templates. If you want an image file to be added as an attachment use the attachment field in the Quicktext settings window.

path [required] The path to the local image file.
type [optional] A type of tag (default) provides the whole html img tag and src provides only the attribute src of the html img tag. (For example to specify the attribute alt with an alternative text.)

Examples:

[[IMAGE=C:\picture.png]] <img src="[[IMAGE=C:\picture.png|src]]" alt="Cats">


INPUT

[[INPUT=name|type|options]]

Displays a prompt and you have to fill in or choose a value.

name [required] The name is shown in the prompt so you know what kind of value you should fill in.
type [required] If you choose text you will be prompted for the the value, if you choose select you can select one of the predefined options.
options [optional] Does not need to be set if you use type text. But if you use type select its needs to be a semicolon-separated list.

Examples:

[[INPUT=Age]] [[INPUT=Creditcard|select|Visa;Master Card;American Express]]


ORGATT

[[ORGATT=separator]]

Gets the attachments from the mail you are answering.

separator [optional] If there are several attachments, this string is used for separating them. Default is ", ". Other examples are "\n" or ",\n".
Examples:

[[ORGATT]] [[ORGATT=\n]]


ORGHEADER

[[ORGHEADER=type|separator]]

Gets the headers from the mail you are answering.

type required Which header you want. For example "to" or "reply-to".
separator optional If there are several headers of the type you chose, this string is used for separating them. Default is ", ". Other examples are "\n" or ",\n".

Examples:

[[ORGHEADER=to]] [[ORGHEADER=received|\n\n]]


SCRIPT

[[SCRIPT=name|...]]

Runs a userscript with the specified name.

name [required] The name of any of your scripts.
... [optional] Any other variable is passed to the script.

Examples:

[[SCRIPT=myscript]] [[SCRIPT=myscript|myvar1|myvar2]]


SELECTION

[[SELECTION]]

Gets the selected text before a template is being added (and replacing that selected text).


SUBJECT

[[SUBJECT]]

Gets the subject.


TEXT

[[TEXT=group|name|options]]

Inserts another template.

group required The name of the group that the text is in.
name required The name of the text you want to insert.
options [optional] Comma separated list of options (v6.*). Supported options:
  • strip_html_comments - Remove HTML comments from file before inserting it
  • force_as_text - Insert file as plain text in HTML composer (v6.*)

Examples:

[[TEXT=mygroup|mytext]]


TIME

[[TIME=type]]

Gets the current time.

type [optional] noseconds, seconds (noseconds: 11:37. seconds: 11:37:54.)

Examples:

[[TIME]] [[TIME=seconds]]


TO

[[TO=type|separator|last separator]]

Gets the value from the to-field.

type required email, firstname, lastname, fullname, displayname, nickname, ...
separator optional If there are several recipients this string is used for separating them. Default is ", ". Other examples are "\n" or ",\n".
last separator optional If there are several recipients this string is used to separate the last two recipients. Default is the same as separator. Other examples are " & " or " and ".

First it tries to get the values from the adressbook. If that not is possible it tries to parse the mailaddress.

Examples:

[[TO=firstname]] [[TO=fullname|,\n]] [[TO=firstname|, | & ]]


URL

[[URL=url|data]]

Makes a POST, GET or OPTIONS call to the specified url and insert the text that is returned.

url required The url that you want the call to be made to.
data optional Specifies what values are POSTed to the url: att, clipboard, counter, date, from, orgatt, orgheader, subject, time, to, version. Alternatively you can change the method by specifying get or options.

Examples:

[[URL=http://example.com]] [[URL=http://example.com|to;from]]

[[URL=http://example.com?parameter=value|get]]


VERSION

[[VERSION=type]]

Gets the version of Thunderbird you are using.

type optional full, number (full: Thunderbird 1.5.0.4. number: 1.5.0.4. )

Examples:

[[VERSION]] [[VERSION=number]]