Every input a tool declares can be set in a link, written by hand or from code. The key is the input's id from the tool's manifest; run lolly <tool> with no flags to list a tool's input ids.
Setting tool inputs
The same values work on the command line as --id=value.
| Input | In a link |
|---|---|
| String, text, longtext, url | The value, URL-encoded |
| Select | The option value, not its label |
| Number | The number |
| Boolean | 1 or true, 0 or false |
| Color | A hex value with its # encoded, or a token reference |
| Asset | A library id, or another tool's embed URL |
| Blocks | A JSON array of objects, URL-encoded |
| Vector | One dotted param per field |
| File | Never in a link; a file path on the CLI |
| Table | One compact param, a ~ between rows |
| Keyframe tracks | A field inside a blocks input, written by the app |
String, text, longtext, url
Pass the value. URL-encode spaces and special characters.
?text=Ship+it
?heading=Quarterly+results
?url=https%3A%2F%2Fexample.comThe Wordmark tool takes only text params, so one link sets the whole wordmark: /t/wordmark?text=Ship it&weight=800&tracking=-12&size=200.
signed by Lollyvector SVG1 path125 nodes5 groups4 KBCheck it yourselfAmbil file bertanda tangan
Select
Pass the option value (not the label).
?theme=dark
?ecl=H?theme=dark repaints the whole design.
Number
?size=800
?padding=4A number can also set a count. Colour Palette builds one ramp cell per step, so /t/color-palette?steps=11 returns a wider sheet than the default seven.
signed by Lollyvector SVG9 groups24 KBCheck it yourselfAmbil file bertanda tangan
signed by Lollyvector SVG9 groups24 KBCheck it yourselfAmbil file bertanda tangan
Boolean
1 or true for on, 0 or false for off.
?join=1
?showGrid=false/t/chart?chartType=line&showPoints=1 marks every data point on a line chart.
signed by Lollyvector SVG26 paths~1.6k nodes5 groups26 KBCheck it yourselfAmbil file bertanda tangan
signed by Lollyvector SVG26 paths~1.6k nodes5 groups26 KBCheck it yourselfAmbil file bertanda tangan
Color
Pass a hex value (URL-encode the #).
?color=%230c322c
?background=%23ffffffA colour can also be a design token reference, such as ?color={color.semantic.primary}. The colour then follows that token's value on the device that opens the link. Design Tokens shows the round trip.
Mesh Gradient takes one colour param per stop, so three hex values in a link are three fields of colour in the render.
signed by Lollyvector SVG9 groups5 KBCheck it yourselfAmbil file bertanda tangan
signed by Lollyvector SVG9 groups6 KBCheck it yourselfAmbil file bertanda tanganTry it in the app
Asset
Pass the asset's library ID. The runtime resolves the ID to the full asset object at render time.
?logo=lolly/logo/primary
?image=lolly/demo/lorikeet-lollipopTo find an asset's id, select the asset in the tool's asset picker and read the value shown. An audio id works the same way: Audiogram decodes the track the link gives and draws its waveform.
A #lolly-version= suffix on an asset value pins one retained version. The link keeps drawing that version after the library changes.
Pinning an asset version (engine 1.185 and later)
AssetRef.pin requests an exact retained version and an optional format. The version property records the last resolution and does not pin an asset by itself. For typed state, use { id: "library/photo", source: "library", pin: { version: "v1", format: "png" } }. The engine's encodeAssetVersion(id, pin) writes the reserved #lolly-version= suffix inside the asset value. Let serializeUrlState do the outer query encoding.
Pins work in top-level and block asset fields. A missing version stays a reference with an empty image URL and a resolution warning. It does not draw current bytes or delete the reference. Uploaded asset ids stay device-local even when pinned. Editable .lolly files and explicit transfers can carry the retained bytes they point at.
signed by Lollyvector SVG5 paths~1.7k nodes10 groups26 KBCheck it yourselfAmbil file bertanda tangan
signed by Lollyvector SVG5 paths~1.7k nodes10 groups26 KBCheck it yourselfAmbil file bertanda tangan
An asset value can also be another tool's render. When a user pastes a Lolly tool link (a share link or an embed URL) into the asset picker, the value's id is the canonical embed URL of that render. The value round-trips through the URL like a library id:
?image=https%3A%2F%2Flolly.tools%2Ftool%2Fqr-code.svg%3Furl%3Dhttps%3A%2F%2Fexample.com%26w%3D600%26h%3D600On load the runtime re-renders the value through host.compose.renderUrl instead of looking it up in the catalog. This puts one tool's output, such as a QR code or a filtered hero graphic, into another tool's image slot through a shareable link. See Tool composition and the authoring guide.
Images you add from your device (AssetRef.source: "user", ids like user/upload/…) live only in that device's storage, so a link leaves them out. The recipient picks their own image, or you send a .lolly file that carries yours (What a link carries).
Blocks
A blocks input is a repeating group of fields, such as team members with a name and a city each. Pass the value as a URL-encoded JSON array of objects.
?people=[{"name":"Mei","city":"Nuremberg"},{"name":"Lisa","city":"Sydney"}]Each object's keys must match the field ids in the tool's manifest. Fields can be omitted - missing fields are treated as empty strings. A field can be left out; a missing field reads as an empty string. Wayfinding's directions input is a blocks list with a label, an arrow, a side and a colour per row, so one link has a whole sign:
signed by Lollyvector SVG7 paths920 nodes21 groups17 KBCheck it yourselfAmbil file bertanda tangan
signed by Lollyvector SVG7 paths920 nodes21 groups17 KBCheck it yourselfAmbil file bertanda tangan
CLI:
lolly meeting-planner --people='[{"name":"Mei","city":"Nuremberg"},{"name":"Lisa","city":"Sydney"}]'A large value packs into the z link. When a link is too long to pass around, the Share dialog offers a .lolly file instead.
Vector
A vector input is a fixed group of numbers edited as one control, such as a zoom and an x/y offset. It has no single-param form. Pass each field as a flat dotted param <inputId>.<fieldId>:
?imageFraming.zoom=200&imageFraming.x=30&imageFraming.y=70Tools such as frame, darkroom, filter, 3d and gradient use vector inputs. Mesh Gradient places each colour stop with one, so adding ?pos1.x=8&pos1.y=8&pos2.x=92&pos2.y=12&pos3.x=50&pos3.y=94 to the gradient above moves its three blooms out to the edges:
signed by Lollyvector SVG9 groups5 KBCheck it yourselfAmbil file bertanda tangan
signed by Lollyvector SVG9 groups6 KBCheck it yourselfAmbil file bertanda tangan
File
A file input (the user's own file, processed in memory) is never put in a URL. Its bytes live only on the device. On the CLI a file param is a filesystem path, loaded into memory before rendering:
lolly strip-data --source=./photo.jpg --output=clean.jpgIn the web shell, a link that references a file input resolves as blank, and the recipient picks their own file.
Table
A table input (a user-defined grid of column headings and rows, such as agenda) is always one compact param. The header row comes first, then one ~-separated segment per data row. Cells are ,-separated and percent-escaped, so commas inside a cell survive:
?t=Pain,Summary,Strategy~Assurance,Is%20it%20open%3F,Table%20stakes%2C%20compete%20with%20whyA JSON form ({"columns":[…],"rows":[…]}) also parses. Long tables use the packed z link like any other big state. Long tables travel in the packed z link. On the CLI the same value works inline, or --<inputId>-data=table.csv fills the input from a CSV / TSV / Markdown-table file (first row = headings):
lolly agenda --sessions-data=./sessions.csv --output=agenda.pdfKeyframe tracks
kf is not an input type. It is a sub-field of a blocks input, one per box in Lolly Design, and uses the block's own encoding under Compact encoding. The app writes the field. Hooks always parse and rewrite the field and never pass the raw field through, so an unparseable or hostile value makes no track.
t0_z0_b4*t1500_eo_z140_b0*t4000_eh_z140_x-60Keyframe track grammar
A box's kf field packs an animation track (position, size, scale, rotation, opacity, blur, depth) into one string of the characters A-Za-z0-9._()- only. separates keyframes; _ separates the tokens inside a keyframe. The first token is always t<ms> (the keyframe's local box time, unscaled). The remaining tokens are channel values and an optional ease token:
- Channels:
x12.5,y-40,s1.2,r15,z140,o0.8,b2.5, the size pairw1280/h720, the tilt pairrx-8/ry20, plus camera-onlyf/a/p. Tilt is a camera channel:rxpitches the camera andryyaws the camera, in degrees, about the point the camera looks at. The centre of the frame stays put and the artwork turns about that centre. Negativerxpitches the camera down over the surface: the near edge of a layer is at the bottom of the frame and the far edge goes toward a horizon at the top. Any non-zero angle makes the projection perspective. A motion export of a tilted scene is captured off the live page frame by frame. A tilted scene that also holds a video clip refuses to export as motion and shows a notice. - Absolute vs relative.
x/y/s/r/o/bare offsets and multipliers over the box's own values, so a track composes with the authored pose and with any enter/exit transition.z,wandhare absolute and replace the box's own field for the segment they are keyed on. Use size when the content must reflow. A keyedwlays out the box again: text rewraps and a border stays one pixel wide.sscales the finished picture. - Path handles:
hi(-80)(-60)andho(80)(-60)bend the travel into and out of a keyframe's position, in px from that position, before any camera. Handles follow the channel tokens and are only on a keyframe that sets bothxandy. A handle of(0)(0)is the same as none. Between two keyframes with a handle, the box travels along that curve at the speed the segment's ease gives along the curve's length. - Ease: one of the eight presets
el/ei/eo/eio/ev/ea/es/ek, the holdehor a paren-delimited beziereb(0.32)(0)(0.67)(1). Absent meanseio(ease-in-out), so an uneased segment is smoothed, never linear. - Longest name wins. A token is read as the longest channel name whose remainder parses as a number:
rx-8is channelrxat -8, never channelrfollowed by junk. A token that matches no channel or ease form is skipped, so a hand-edited link does not fail the render.
Compact encoding (opt-in)
Tools can opt into a shorter form. The web app writes this form when you copy a share link; the live address bar keeps the readable long form. Both forms parse, so either kind of link works. Both forms parse.
Long form
?chartType=radar&palette=cool&heading=Short+keys&showLegend=0Compact form
?ct=radar&pl=cool&t=Short+keys&lg=0urlKeyaliases. An input or block field can declare a short key, such astextColor→tc, so?tc=ff0000sets that input.- Colours without
#. A 6-character hex is stored bare (?color=0c322c) and gets its#back on parse. - Tilde-delimited block arrays. Instead of JSON, blocks are written as
field,field,field~field,field,field: one~-separated group per item, values URL-encoded, colours without#. - Omitted defaults. A value equal to the input's default is left out of the link.
Lolly Chart uses short keys, so a link copied from its Share button takes the compact form. ?ct=radar&pl=cool&t=Short keys&lg=0 sets the chart type, palette, heading and legend:
signed by Lollyvector SVG11 paths808 nodes2 groups15 KBCheck it yourselfAmbil file bertanda tangan
signed by Lollyvector SVG11 paths808 nodes2 groups15 KBCheck it yourselfAmbil file bertanda tangan