Tags by option

Every option a tag takes of its own, and what it does there. The handling options every tag takes - sort, where, first, rows, group and the rest - are not listed here.

OptionTagMeaning
access {meta} Kept for access rules to read with padMeta ( 'access' ).
action {pull} Any sequence action written as an option (or named with action='last|2'), applied to the stored values in the order written: reverse, sort, sum, first=3, last=3, append='other', ... shift=n and pop=n also take the values out of the store.
{resume} Any sequence action, as an option of its own or named with action='reverse' - reverse, sort, sum, first=3, ... - or a play with a type: add=10 (make), keep, prime, remove, even, flag, odd.
{sequence} Names an action explicitly, its value after a |: action='first|3'. Usually the action is written as an option of its own, applied to the result in the order written: sum, average, median, count, reverse, sort, shuffle, dedup, first=n, last=n, append='store', ...
active {tabs} The tab shown first: its number counted from 1, or its label. The first tab when not given.
ajax {page} With app=: ajax=false fetches the other application's page on the server and inserts its body instead of leaving it to the browser.
alt {gravatar} The image text - the person's name - default Avatar.
{img} Required: the text for whoever cannot see the picture. alt='' marks it as decoration.
app {ajax} A page of another application; under the strict check it must exist there.
{page} A page of another application. It cannot be built in this process, so it is fetched over HTTP - by the browser by default (as {ajax} does).
arrow {chess} Arrows from square to square, separated by commas: 'e2-e4, g1-f3'.
arrows {chart} Bare option, network: draws the direction of the links.
at {video} The moment to start at - 90, 1m30s or 1:30; a t=, start= or #t= in the address says it too.
background {barcode} The colour behind them, default #fff.
{qr} The light colour, default #fff.
bands {chart} Gauge and bullet: thresholds that split the track into coloured or grey steps ('60, 85').
bandwidth {chart} Density, violin: the width of the kernel, else Silverman's rule.
base {files} What the directory is relative to: app (the application), data (DATA/) or pad (the path as given); otherwise the file system root. It must lie inside the applications, the engine or DATA.
bcc {mail} Blind copy addresses.
bins {chart} Histogram: about how many bins (10).
button {modal} The text of the button that opens the dialog, Open when not given.
{poll} The text of the vote button, Vote when not given.
by {chart} Multiples: the field that splits the rows into small charts.
cache {meta} The page's own server-cache time in seconds, in an application with the page cache on; 0 or false keeps the page out of the cache.
caption {datatable} The table's <caption>.
cc {mail} Copy addresses.
cells {chart} Waffle: the number of squares (100).
checked {input} Bare option: a checkbox or radio is checked before a post.
children {tree} The field of a row that holds its children, at every depth. Default children.
clean {code} Bare option: the pass sees everything around it, but every variable it creates or changes is undone afterwards.
{page} Bare option: the page sees everything around it, but whatever it creates or changes is undone afterwards.
client {form} Bare option: check the rules= of the fields in the browser too, with the same messages - the form gets novalidate, data-pad-rules and the checker script.
color {barcode} The colour of the bars, default #000.
{chart} Scatter, bubble, gantt, parallel: a field whose values colour the marks, with a legend.
{progress} A colour slot: accent (default), success, warning, danger or neutral.
{qr} The dark colour, default #000.
{timeline} A field that groups the events: a colour each and a legend.
columns {chart} Multiples: the number of small charts side by side.
{datatable} The fields shown, in their order. Every field of the first row when not given.
cookies {curl} An array of cookies to send.
count {trans} Picks the plural form of a text with | between its forms, and replaces %d in it.
css {shadow} Stylesheets inlined as one <style> at the start of the root, separated by commas: a .css file of the application, or www: one of its www/ directory.
data {calendar} The events: a {data} store, a page array or a _data file, as for {chart}.
{chart} The rows: a {data} store, a sequence store, the page's array or a _data file of that name, or a literal (data='[3,1,4]'). Left out on a pair, the content is the data.
{datatable} The rows: a {data} store, a page array or a _data file. As a pair the content is the rows instead - JSON, YAML, XML or CSV, told apart on sight.
{jsonview} Names the value instead: a {data} store, a page array or a _data file.
{map} The rows: a {data} store, a page array or a _data file, as for {chart}. As a pair the content is the rows - JSON, YAML, XML or CSV.
{sparkline} The rows: a {data} store, a sequence store, an array of the page (or a field of the current row holding a list) or a _data file of that name, or a literal (data='[3,1,4]'). Left out on a pair, the content is the data.
{timeline} The rows: a {data} store, a page array or a _data file, as for {chart}. As a pair the content is the rows - JSON, YAML, XML or CSV.
date {calendar} The field with an event's date - by default the first field that reads as one.
{chart} Calendar: the field with the day.
{file} Bare option: _Y-m-d of today added to the name.
{timeline} The field of a moment: a year (1969), a month (2026-10) or anything strtotime reads - else the first field that reads as one.
default {gravatar} What Gravatar shows for an address it does not know: mp (default), identicon, monsterid, wavatar, retro, robohash, blank, 404, or an https:// image address.
dir {file} The directory below DATA/; none writes in DATA/ itself.
direction {diagram} TB (default), BT, LR or RL - else a first line graph LR or flowchart LR names it.
download {pdf} Bare option: sent as an attachment (Content-Disposition: attachment) instead of shown inline.
edges {diagram} How a flowchart's edges run: orthogonal (default, rounded turns), straight or curved.
ellipsis {excerpt} What stands for the text that was cut off, default ….
error {form} The message shown above the fields, in <div class="error" role="alert">, when the form came back with errors. Bare option: Please correct the errors below.
exclude {files} Leave out the names that match this shell pattern.
ext {file} The extension, ext by default.
fallback {gravatar} avatar draws the {avatar} initials of alt (or of the address) instead, identicon the {identicon} of the address - no <img>, no outside request.
file {highlight} A file of the application to show instead of the content - never one outside it, under _config/ or a dotfile.
{pdf} The file name of the document, default the page's name (.pdf is added).
files {source} Files after the page's, a text with commas: a file of the application, or www: one in its www/ directory.
fit {img} cover (default: fill the box, cut around the centre) or contain (all of the picture inside the box).
flip {chess} Bare option: turn the board, Black at the bottom.
fluid {placeholder} Bare option: as wide as the container (width="100%"), the height following from the proportions.
focus {shadow} Bare option: adds shadowrootdelegatesfocus.
font {pdf} helvetica (default), times or courier - code is always Courier.
format {countdown} The PHP date format of the full moment in the title, default l j F Y, H:i.
{datatable} A pipe per column, column:pipe separated by commas - total:money, date:date('j M').
{img} jpeg, png or webp - default the source's, a GIF becoming a PNG.
{timeago} The PHP date format of the full moment in the title, default l j F Y, H:i.
{timeline} A PHP date format for the dates written - else by the date's precision (1969, Oct 2026, Oct 8, 2026).
fragment {ajax} Ask the page for one of its response fragments alone - &padFragment=name - instead of the whole page.
from {chart} Gauge: the start of the scale (0). Gantt: the field with the start of a task.
{diff} The name of the old version - a column head side by side, a caption in one column.
{mail} The sender, $padMailFrom by default.
{sequence} Where the generating loop starts (default 1). A value for a type that tests candidates (prime), a position for one that computes the nth term (fibonacci, square).
{timeline} The field with the start of a span, drawn as a bar (with to).
function {code} Runs the pass inside a PHP function of that name, giving it a variable scope of its own; what it creates is copied out afterwards (not with sandbox).
{page} Runs the page inside a PHP function of that name, so its PHP has a scope of its own; what it creates is copied out unless sandbox is given too.
{sandbox} Runs the pass inside a PHP function of that name, with a variable scope of its own; being sandboxed, nothing is copied out.
get {curl} An array of query values added to the URL.
headers {curl} An array of request headers.
height {barcode} The height of the bars in pixels, default 60.
{chart} The height in pixels, default 300 (round kinds 280, the tall kinds 400, gauge 200, calendar 150).
{img} The height of the box in CSS pixels.
{map} The height in pixels; by default it follows from the view.
{sparkline} The height in pixels, default 32.
{timeline} The height in pixels; by default it follows from the cards (not in the vertical form).
highlight {chess} Squares to mark, separated by commas: 'e2, e4'.
{excerpt} Search words - a query, split at everything that is no letter or digit. The cut is centred on the first match and every match is put in a <mark>.
html {collection} Bare option: raw HTML in the Markdown bodies is let through. By default it is escaped.
{excerpt} Bare option: the text is HTML - its tags (and the content of script and style) are dropped and its entities read before it is cut.
{markdown} Bare option: let the author's own raw HTML through - inline tags, and a block-level element or comment at the start of a line up to the next blank line. Without it raw HTML is escaped.
icon {rating} star (default) or heart.
id {chart} Orgchart: the field with a row's id.
{file} A random suffix of this many characters added to the name.
{input} The id, by default the name.
{reactData} The id of the <div>, and the key the result is kept under in $padProviders - default myReactId.
{textarea} The id, by default the name.
ignore {markdown} Bare option: the braces in the content are text, not tags - for code samples in the Markdown.
include {page} Whether the page renders bare. TRUE by default - the _inits.pad/_exits.pad wrappers are left out; include=false wraps it as a request would.
includeHidden {files} Bare option: names starting with a dot too.
increment {sequence} The step of the loop, 1 or more (default 1).
keep {pull} A play with a type: keep, prime or keep='prime' keeps the members, and likewise remove, flag and make.
{sequence} A play: keep, prime (bare, followed by a type) or keep='prime' keeps only the values that belong to that type. Also remove, flag and make; see those tags.
key {map} The field with the country: its ISO 3166 alpha-2 or alpha-3 code or its English name, in any case - else the first field that is no number.
label {avatar} The accessible name (aria-label and <title>), by default the name.
{carousel} The carousel's name for a screen reader, Carousel when not given.
{chart} The field for the category axis or the names - else the first other field, else the row number.
{copy} The text of the button, Copy when not given.
{emoji} The name a screen reader says, default the emoji's own name.
{icon} The accessible name: the icon becomes role="img" with aria-label and <title>. Without it the icon is decoration.
{input} A <label for> before the field - after a checkbox or radio - and the word its error message uses.
{progress} Shown above the bar and the accessible name; default Progress (not shown).
{rating} The accessible name, default 4.5 out of 5.
{sparkline} The field naming each point, used in the description read by a screen reader.
{textarea} A <label for> before the text area, and the word its error message uses.
{timeline} The field with an event's title - else the first other text field.
labels {datatable} The header of each column, in the order of columns. The field name as a headline when not given (order_date is Order Date).
landscape {pdf} Bare option: the page turned.
layout {chart} Network: force (default) or radial.
{meta} Frames the page with that layout, as {extends} does.
level {qr} Error correction: L (7% of the symbol may be lost), M (15%, default), Q (25%) or H (30%).
levels {chart} Treemap, sunburst, pack: the fields above the parts, outermost first.
{toc} The heading levels listed - a list or a range, '2,3' by default, '2-4'.
line {chart} Dual: the field drawn as a line on the right axis, beside the bars of value.
lines {diff} Bare option: compare line by line - a table with the old and the new line number, a sign and the line.
{highlight} Bare option: number the lines.
link {calendar} A field with a link for the event - http(s), a page or an anchor; never javascript: or data:.
list {sequence} An explicit list of values, separated by ;: list='3;1;2'.
{toc} ol (numbered, the default) or ul.
live {countdown} Bare option: a small script, once per page, counts down every second from the browser's clock.
mark {chart} Gantt: a date marked with a dashed line.
{highlight} Lines to set apart: '4', '3, 5-7'.
mask {files} Only the names that match this shell pattern - *.pad.
max {progress} What the value counts to, default 100. With steps the number of steps, a whole number up to 50.
{rating} The number of icons, a whole number from 1 to 20, default 5.
maximal {sequence} Leave out terms above this value.
method {form} post (the default) or get. A GET form gets no token and no name field, and its fields refill from the query string.
minimal {sequence} Leave out terms below this value.
mode {shadow} open (the default) or closed.
name {array} Names the level, so its properties read first@orders; in the designer preview (&padSample) the sample's rows of that name answer instead of the database.
{check} In the designer preview (&padSample) the sample's value of that name answers, true or false, instead of the database.
{country} Bare option: writes the English name beside the flag; the flag is then decoration (aria-hidden).
{field} In the designer preview (&padSample) the value of that name in the page's sample answers instead of the database; &padSample=capture records the database's answer under it.
{file} The file name, file by default.
{record} In the designer preview (&padSample) the sample's row of that name answers instead of the database; a capture records the database's answer under it.
{sequence} The field the current value is written to, instead of $sequence; the result is also stored under it, like push.
{trans} Any other name: its value replaces :name in the text. The names are read raw, so even content= or data= is a substitution here.
negative {sequence} Bare option: invert the selection of an action - first=3, negative is all but the first three.
now {countdown} Count from this moment instead of now.
{timeago} Count from this moment instead of now.
once {push} With a key: the first push of that key to this stack is kept, later ones are skipped before their content renders. Bare: a push whose rendered text the stack already holds is dropped.
only {source} Those files alone, without the page's - the same kind of list as files=.
onlyDirs {files} Bare option: directories only.
onlyFiles {files} Bare option: files only.
open {accordion} The item open at first: its number from 1 or its label. Bare, open opens every item.
{chart} Candlestick: the field of the opening price (also high, low and close, each defaulting to its own name).
{jsonview} The number of levels shown unfolded, 2 when not given; 0 folds everything.
options {curl} An array of curl options by name.
{poll} The answers, separated by commas - two or more; duplicates and empty ones are dropped.
paragraphs {lorem} So many <p> paragraphs, of four to seven sentences unless sentences says.
parent {chart} Orgchart: the field with the id of the row above.
password {curl} The password of basic authentication.
past {countdown} The text once the moment has gone, default ended.
percent {chart} Bare option, area: every column stacked to 100%.
period {chart} Spiral: rows to one turn (12).
plain {barcode} Bare option: the bars only, no digits under them.
post {curl} The body to post - the request is then a POST.
poster {video} A picture of www/<application>/ (versioned as {asset}) in place of the site's thumbnail.
preview {pdf} Bare option: the page stays a page - the content on a sheet with links to open or download it; the same page asked with &padPdf (padPdf=download for the attachment) answers the PDF.
progress {chart} Gantt: the field with the part done, 0 to 100.
provider {reactData} The file _providers/<name>.php that answers the data - default the id. A plain name only.
pull {sequence} Start from a stored sequence instead of generating one.
push {sequence} Store the result under this name, for {pull}, {resume} and {action}.
quality {img} 1 to 100 for JPEG and WebP, default 80.
query {calendar} The request value the links to the months around set, and that picks the month when no parameter is given; default month.
{datatable} A prefix for the request names sort, dir and page - for two tables on one page.
{pager} The request value the links set. By default the variable page= was written with - page=$pg makes the links set pg - else page.
randomly {sequence} Bare option: take the candidates in random order instead of from low to high.
range {sequence} The range as an option: range='20..30'.
ratio {placeholder} Proportions instead of a size ('16:9'), drawn width pixels wide.
{video} The proportion, default 16:9; a short is 9:16 and kept to a phone's width.
react {vite} Bare option: with the dev server, write the preamble the React plugin needs for fast refresh first.
recursive {files} Bare option: the subdirectories too - every file below, item holding the path.
replyTo {mail} The Reply-To address.
reset {code} Bare option: the level arrays and the data, content, bool and sequence stores are cleared for the pass and restored after it; variables stay visible, and what the pass sets stays behind.
{page} Bare option: the level arrays and the stores are cleared for the pass and restored after it; the application's variables stay visible.
results {poll} Bare option: show the results to everyone, also before a vote.
rows {datatable} Rows per page, with page links below (?page=2).
{sequence} How many terms to produce - for a sequence this counts produced terms whatever the type, so it is the way to ask for "the first ten".
rules {input} The field's rules - required|email|max:80 - read from the page's own template and checked before its PHP runs. Only in a named {form} of the page itself.
{textarea} The field's rules - required|max:2000 - read from the page's own template and checked before its PHP runs. Only in a named {form} of the page itself.
sandbox {code} Bare option: the pass sees none of the page's variables and stores and leaves none behind - what {sandbox} does.
{page} Bare option: the page runs isolated - it sees none of the variables and stores of the page around it, and leaves none behind.
scale {barcode} The width of one module - the thinnest bar - in pixels, default 2 (1 to 10).
{map} linear (default: seven equal steps from the lowest value to the highest) or quantile (seven steps by rank).
seed {lorem} Another text, the same again for the same seed - default 0.
sentences {lorem} So many sentences of six to fourteen words; with paragraphs, the sentences of each paragraph.
sequence {chart} Plot the first rows terms (default 10) of a sequence type instead of rows.
{sparkline} Plot the first rows terms (default 10) of a sequence type.
sets {chart} Venn: the field naming a set (A) or an overlap (A&B).
shape {avatar} circle (default) or square - with rounded corners.
side {diff} Bare option: the lines side by side, a changed line beside its counterpart, line numbers on both sides.
single {accordion} Bare option: one item open at a time - the items share a name, the exclusive accordion of HTML.
sitemap {meta} false leaves the page out of {sitemap}; read with padMeta ( 'sitemap', 'page' ).
size {avatar} Width and height in pixels, default 48.
{chart} Bubble: the field that gives each dot its area.
{chess} Width and height in pixels, 360 when not given (80 at least); the board shrinks to fit a narrower container.
{gravatar} Width and height in pixels, default 64; the srcset asks twice that for a sharp screen.
{icon} Width and height in pixels, default 20.
{identicon} Width and height in pixels, default 64.
{pdf} A4 (default), Letter, A5 or Legal.
{progress} small, medium (default) or large - the height of the bar or the dots.
{qr} Width and height in pixels, the quiet zone of four modules included; default 160, at least 21.
{rating} The height in pixels, default 20.
skip {sequence} Skip the first N candidates the loop offers (not the first N kept).
slug {collection} Only the file of that name (without .md). A slug that names no file, or is not a plain file name, gives no rows - the @else@ branch.
solution {crossword} Bare option: write the letters in the grid and the answers behind the clues.
solve {sudoku} Bare option: fill the open cells with the solution, in another colour than the givens.
sortable {datatable} Bare option: every header is a link that sorts on the server, ?sort=total&dir=desc.
source {chart} Sankey, network, chord, arc: the field of where a link starts.
square {chart} Bare option, proportional: squares instead of circles.
stacked {chart} Bare option, bar, hbar and area: the series one on the other instead of side by side.
stamp {file} Bare option: a time stamp added to the name.
steps {progress} Bare option: a dot per step joined by a line, the steps up to the value filled and the current one ringed.
stop {sequence} End at the first term that reaches this value - that term included.
striped {datatable} Bare option: every other row shaded.
stroke {icon} The line width on the 24-unit grid, default 2.
sub {chart} Orgchart: a field for the second line of a box.
subject {mail} The subject - required.
sunday {calendar} Bare option: the weeks start on Sunday instead of Monday.
tag {asset} Bare option: write the element instead of the address - <link rel="stylesheet"> for .css, <script defer> for .js, <script type="module"> for .mjs.
target {chart} Sankey, network, chord, arc: the field of where a link goes. Gauge and bullet: the value (or field) marked as the goal.
template {mail} A template in _mail/: order.pad the HTML part, order.txt the text part, order.php run first. Without it the pair's content is the HTML part.
text {placeholder} Written in the middle and the accessible name; by default the size (600 × 300) or the ratio.
{timeline} The field with the line under the title - else the next text field.
title {barcode} The accessible name, by default the code.
{calendar} The field with an event's text - by default the first other text field.
{chart} The accessible name in the SVG's <title>; by default made from value and label.
{chess} The accessible name of the board. Chess position, White to move when not given.
{crossword} The grid's accessible name, Crossword when not given.
{diagram} The accessible name, default Flowchart or Sequence diagram.
{identicon} The accessible name, default Identicon - the value itself is not written into the page.
{jsonview} A label for the outermost level.
{map} The accessible name, default <Value> by country.
{meta} Like any other name: becomes the variable $title, which a wrapper's <title> shows.
{modal} The heading of the dialog, which also names it for a screen reader. The button's text when not given.
{pdf} The document's title, default its first heading.
{poll} The question. The name made readable when not given (favorite-language is Favorite language).
{qr} The accessible name, by default the text itself.
{sparkline} The accessible name, the SVG's one <title>.
{sudoku} A caption for the table. Without it the table is named by aria-label (Sudoku, 30 givens).
{timeline} The accessible name, default Timeline.
{toc} The label above the list, Contents by default; '' for none.
{video} Required: the play button's text, the iframe's title, the video element's name.
to {chart} Gauge: the end of the scale (100). Gantt: the field with the end of a task. Radar, radialbar, rings, bullet: the end of the scale, a number (or for rings and bullet a field).
{diff} The name of the new version.
{mail} The address or addresses - ann@example.com, Ann <ann@example.com>, several separated by commas.
{sequence} Where the loop ends, counting the same way as from.
{timeline} The field with the end of a span.
toData {sequence} Also keep the values as a data set of this name, iterated as {name}.
token {csrf} Bare option: the token alone instead of the hidden field - for a script that sends it back in an X-CSRF-Token header.
total {chart} Waterfall: the name of the closing bar (Total); total='' leaves it out.
totals {datatable} Columns summed in a totals row - over every row, not only the page shown.
trend {chart} Bare option, scatter and bubble: adds the least-squares line.
ttl {cache} The seconds the rendering is kept, 300 when not given.
{curl} Keep the answer this many seconds; when the source fails afterwards the last good copy is served and the failure logged.
turn {chart} Spiral: the field that names each turn.
type {barcode} ean13, ean8, upca or code128. Left out, twelve or thirteen digits are an EAN-13 and anything else Code 128.
{chart} For a pair: the format of the content - json, yaml, xml or csv - when it is not to be recognised on sight.
{data} The format of the content - json, xml, yaml, csv, list, range ... - when its first characters do not tell.
{diagram} flowchart (default) or sequence - a first line sequenceDiagram says so too.
{input} The input type, text by default: email, number, checkbox, radio, hidden, password, file, submit ...
{reactData} check turns the result into 1 or 0; otherwise (record, the default, or array) it is passed as the provider returned it.
{sparkline} For a pair: the format of the content - json, yaml, xml or csv - when it is not to be recognised on sight.
unique {sequence} Bare option: leave out a term that is already in the result.
unit {chart} Gauge: written after the number.
units {countdown} How many units are shown, 1 to 4 (days, hours, minutes, seconds), default 2.
user {curl} The user name of basic authentication.
value {chart} The field with the number - else the first numeric field. A comma list draws a series each (eight at most) for bar, hbar, line, area, stream, radar, rose, marimekko, pyramid and parallel. For a gauge it can be the number itself.
{input} The value before anything was sent; for a checkbox or radio its own value (on by default).
{map} The field with the number - else the first numeric field.
{sparkline} The field with the number - else the first numeric field.
{textarea} The text before anything was sent, escaped.
varied {lorem} Bare option: leave the classic opening "Lorem ipsum dolor sit amet" out - for the second text on a page.
vary {cache} Whatever else the rendering depends on: vary=$userId keeps a copy per user, vary=$country one per country.
vertical {timeline} Bare option: dates on the left and cards on the right, one under the other - for a long list.
volume {chart} Candlestick: a field of volumes drawn as light bars below.
width {chart} The width in pixels, default 600 (round kinds 480, gauge 320, calendar 720).
{img} The width of the box in CSS pixels. With only one of width and height the picture keeps its proportion; with neither it keeps its size.
{map} The width in pixels, default 720.
{placeholder} The width of a box drawn from ratio, default 640.
{sparkline} The width in pixels, default 120.
{timeline} The width in pixels, default 720 (vertical 600).
window {pager} The number of pages shown on each side of the current one; 2 by default. The first and the last page always show, a gap (…) stands for the pages left out.
words {excerpt} The length in words, default 40. A text no longer than that stays whole.
{lorem} So many words exactly, as sentences; fewer than five are a title, without a full stop. 50 when no length is given.
x {chart} Scatter, bubble, heatmap: the field of the horizontal axis (heatmap: the columns).
y {chart} Scatter, bubble, heatmap: the field of the vertical axis (heatmap: the rows).
year {chart} Calendar: draw the whole year instead of the span of the data.