How to Install the Agent on a Tilda Website

A step-by-step guide on where to insert the widget code in Tilda, how to link it to your cart, how to handle caching, and how to verify the agent works across all pages.

September 6, 2026

Tilda is a common case for our shops: the website looks great, products are listed, but there's no one to answer customer questions. Setup takes five minutes and doesn't require a programmer.

Step 1. Copy the Code#

In your account, open “Widget and Link” and click “Copy Code”. This is a single line like <script src="…" async></script>.

Step 2. Paste it into Tilda#

1. In your Tilda personal account, open the desired project.
2. Click “Site Settings”.
3. Go to “More” → “HTML code for insertion inside head/body”.
4. Paste the code into the HTML code for body field (not in the head).
5. Save.

Next is a mandatory step that people often forget: republish all pages. Tilda applies the code upon publication, so the widget won't appear on unpublished pages. There's a button to publish all pages at once in the page list.

Step 3. Connect to the Cart#

If you have a Tilda shop with its own cart, you don't need to enable in-chat payments. Instead, specify the cart link in your shop settings: this is usually the address of your website's cart page. The agent will guide the buyer to it, and checkout will proceed as usual.

If there's no cart and products are sold “on request”, enable in-chat payments — then the entire process will stay within the chat. Details are in the article In-Chat Payments.

Step 4. Build Your Catalog#

In the settings, enter your website address and start the analysis. The crawler reads Tilda product cards, including prices, characteristics, and photos, and also determines the shop's currency.

If your products aren't in the Tilda catalog but are described in blocks on pages, the crawler will still find prices and names, but the product cards will be rougher. In this case, importing a CSV from “Catalog” helps — Tilda can export products to a file.

The Agent Doesn't Just Talk About Products — It Leads to Them#

This is where the chat stops being just a chat. A buyer asks “what do you have under three thousand”, and the agent responds not with a paragraph of text, but with product cards: photo, name, price, button. Clicking opens that very product page on your website — in the same window, without a new tab and without losing context.

Then the person enters the familiar Tilda funnel: your product card, your “Buy” button, your cart. The agent led, the shop sold.

Second, something people usually don't expect: the agent sees which page the buyer is currently viewing. It extracts product markup from the page — name, SKU, price — and understands the question in context. Someone is on the page for a blue armchair and writes “do you have cushions for it?” — the agent knows which armchair they're referring to and offers what truly fits.

The product link also works where there's no website: if the product card came from an Instagram or TikTok post, the button will open the original post. The catalog is compiled from various sources, but always leads to where a purchase can be made.

1. Open the website in incognito mode. The chat button should appear in the bottom right corner within a second or two.
2. Ask a question about a product — the agent should display a product card.
3. Ask about delivery — the answer should match your terms.
4. Check on your phone: on the mobile version, the button should not overlap the Tilda cart.

If the button overlaps something important, change its position to the left in the “Widget and Link” section.

Chat That Matches Your Site's Tone#

Tilda sites can be both light and distinctly dark, so the widget has three theme modes: light, dark, and “as per visitor's settings”. The latter adapts to the user's device settings and is the default.

If your site is designed with a consistent theme, set the widget to that theme explicitly — the chat will no longer stand out like a patch in the corner. The accent color, however, remains yours in any theme.

Step 5. Check#

Common Issues#

Widget did not appear. Nine times out of ten, pages were not republished after the code was inserted. Republish and refresh the page with a cache clear.

Widget not visible on all pages. The code was inserted not in the site settings, but in a separate T123 block on a single page. Move it to “Site Settings” → “More”.

Button appears with a delay. This is normal: the script loads asynchronously, after the main content, to avoid slowing down the page.

Conflict with another chat. Two chats in the same corner overlap each other. Keep one or move them to different sides.

Frequently Asked Questions#

Is a Paid Tilda Plan Required?#

The code is inserted in the site settings, which is available on paid Tilda plans. On the free plan, custom code insertion is not supported — in that case, use the agent link and place it as a button on your page.

Will the Widget Slow Down the Site?#

No. The script is lightweight and loads asynchronously; the chat window itself only loads when the button is clicked. This does not affect Tilda page load speed.

Can the Agent Be Placed on Only One Page?#

Yes, insert the code not in the site settings, but in the “T123 HTML” block on the desired page. This is done, for example, for a single product landing page.

Does This Work with Tilda Store?#

Yes. The agent reads product cards and the cart, leaving the checkout process to the Tilda shop: the buyer proceeds to your cart with the selected product.

How to Remove the Widget from the Site#

Delete the code line in the site settings and republish the pages. Data and dialogues are retained, and the agent link will continue to work.