Requirements for Uploading a Custom Landing Page

A Custom landing page in Chatterfy is your own HTML file uploaded as a ZIP archive. Unlike a Default landing page (where we provide ready-made templates), Custom gives you full control over the page d

Updated August 17, 20263 min

For the landing page to work with Tracker, it must meet two requirements: the correct archive structure and the correct markup for transition buttons.

1. Archive structure

Format — .zip.

Inside the archive, the root must contain the index.html file.

Assets (CSS, JS, images, fonts) should be next to index.html or in subfolders. All paths in HTML must be relative, not absolute. For example, <img src="img/logo.png">, not <img src="/img/logo.png">.

Do not use external connections to your own CDNs that may be unavailable to the lead in the Telegram browser. If you use a font from Google Fonts or a script from a CDN, make sure it definitely loads on mobile.

Do not put the landing page in a subfolder

A common mistake is to archive the landing page folder, which results in mysite/index.html inside the ZIP instead of index.html. Tracker will not find the entry file and will reject the archive. Archive the contents of the folder, not the folder itself.

2. Transition button markup

The landing page will have buttons or links that the lead uses to go to Telegram. To let Tracker insert the ad link with the clickid at the moment of the click, mark these elements with the special tracker attribute.

Markup example:

<a tracker>Перейти в Telegram</a>
<button tracker>Войти в канал</button>
<a tracker class="btn-primary">Открыть бота</a>

You do not need to hardcode the href="..." link — Tracker will insert it automatically when rendering the landing page for a specific click. You can add the tracker attribute to any number of elements: all of them will become clickable links with tracking.

Any tag with tracker becomes a link

Not only <a> — <button>, <div>, <span>, and any other element with the tracker attribute will also work as a transition button. This is useful for designer buttons with a background image and custom markup.

How to upload

Open Tracker → Landings

In Landings — Telegram redirect landing pages click create a new landing page, select the Custom type (see Custom — your own ZIP archive).

Upload the ZIP

Select the file and wait for the upload to finish. Tracker will unpack the archive, check for index.html, and parse the button markup. If something is wrong, it will show an error.

Connect it to a campaign

In Campaigns — advertising campaigns select the uploaded landing page for the required campaign. After saving, the landing page link is ready — you can use it in ads.

Frequently asked questions

Landings — Telegram redirect landing pages

The Tracker → Landings section contains pages that users pass through before getting to Telegram . When a lead clicks an ad, they first see the landing page, read / watch the content, and only then cl

Custom — your own ZIP archive

Custom is a landing page mode in which you upload your ZIP archive with a ready-made HTML page to Tracker. Tracker uses the archive contents as the basis for the page. Layout, design, logic, animation

Default — standard template

Default is the standard landing page mode in Tracker. It is a ready-made template for a Telegram transition page where you fill in a few fields: title, description, avatar, and button texts. You don’t

How to create a landing page

This guide takes you from an empty list to a finished landing page connected to a campaign. Time: 5-15 minutes for Default, 30-60 minutes for Custom (if the ZIP is already prepared). What to prepare D

Was this article helpful?