Documentation

Landing pages in Velotrak

Updated 17 Nov 2026

A lander is either files Velotrak serves at /lp/<id>/ or an external URL. Upload a ZIP of up to 25 MiB, or edit HTML, CSS, and JS in the file API. Put index.html at the root so the lander URL has a page.

Create the lander

Choose hosted or external. An external lander needs an http or https URL in path_or_url. A hosted lander stores files on disk under the data directory. Status is active, paused, or draft. A paused lander is not offered to new clicks. You can turn on inject_js, which appends the tracker script /velotrak.js.

LP Protect (protect_enabled) is a Pro feature, and Founder follows Pro. On Free the flag is refused. When it is on, the click adds a short-lived vt_lp token bound to IP and user agent (5 minutes). A valid visit then gets a session cookie for 2 hours. Anyone else receives an empty 403 page. Preview over plain HTTP can fail to load that page’s CSS and JS. Give the admin its own hostname before operators upload pages; a lander opened on the admin host is sandboxed, but a separate admin domain is the isolation the server documents.

Upload a ZIP

POST /api/landers/{id}/upload reads one multipart file. The archive may be 25 MiB. The request itself is read up to 26 MiB. Extraction allows 500 entries after junk is stripped, 25 MiB per entry, and 100 MiB uncompressed. Paths that contain .., symbolic links, and directory entries are rejected. __MACOSX and .DS_Store are stripped. A ZIP that is a single folder is unwrapped.

/lp/<id>/ serves index.html at the lander root. The name is case-sensitive. If the ZIP has no index.html, the upload response includes warning: no_index and the HTML files it did find.

Edit files

The file API is GET, PUT, and DELETE on /api/landers/{id}/files and /api/landers/{id}/files/<path>. Text extensions are .html, .htm, .css, .js, .json, .txt, .svg, .xml, and .md. One file may be 2 MiB. The same calls exist as MCP tools (list_lander_files, read_lander_file, write_lander_file, delete_lander_file). Writes and deletes ask you to confirm a diff. See MCP.

Macros and preview

When the lander URL has a click_id, these tokens in the HTML are replaced: click_id, campaign_id, flow_id, lander_id, offer_id, country, device, os, browser, token1–token10, zone, and {offer_link}. {offer_link} becomes /go or /go?cid=....

Preview is POST /api/landers/{id}/preview-link. The relative URL uses click_id=preview and sample values (country US, device Mobile, OS iOS, browser Safari), plus vt_lp when LP Protect is on.

The public page is GET /lp/<lander id>/<path>. A missing file is 404. Campaign routing is described under concepts.