All Collections
Guides
How do I update the Tito Widget from version 1 to version 2?
How do I update the Tito Widget from version 1 to version 2?
Cillian O'Ruanaidh avatar
Written by Cillian O'Ruanaidh
Updated over a week ago

Version 1 of the Tito widget is now deprecated and from the 31st of March 2023 we will be removing support completely. So if you are using version 1 you will need to migrate to version 2 before then.

Why?

Version 2 is faster, leaner and has a modern UI. It also has better support for people registering via mobile and includes a new plugin system which makes it easy to include predefined integrations with third-party tools e.g. Google Analytics/Facebook ads/etc.

How do I update to version 2?

In the simplest case, you will only need to change two lines of code to update to version 2:

Step 1 - Replace <script src="https://js.tito.io/v1" async></script> with <script src="https://js.tito.io/v2" async></script>

Step 2 - Remove <link rel="stylesheet" type="text/css" href="https://css.tito.io/v1.1" />. This line is no longer necessary because in version 2 CSS styles are loaded automatically.

However, depending on your needs and how you have setup version 1, there may be some other steps you need to take. We have outlined some of these scenarios below, so we recommend you have a quick read through them to make sure you don't miss anything if they apply to you. Although if you are unsure about anything, you could checkout our version 2 docs or feel free to contact us at support@tito.io and we'll do our best to help.

Do you want to record visitor statistics in Tito?

In version 1 visitor statistics were recorded by default. In version 2 they are not recorded by default, but using version 2's new plugin system you can make sure they are recorded by using the following script tag:

<script src="https://js.tito.io/v2/with/hits" async></script>

I'm using the Tito Wordpress plugin, how do I update that to version 2?

If you are using the Tito Wordpress plugin you need to update the plugin to the latest 2.1 version in your Wordpress Plugins section. Note, there will be a new "plugins" field in the Tito settings section of your Wordpress admin area. Here you can enable version 2 plugins, like hits for example which you will need if you want to record visitors statistics

in Tito.

Can I customise the version 2 widget styles to match my branding?

Yes, this is possible just like in version 1. To do this you need to enable the widget in inline mode using the inline plugin like this:

<script src="https://js.tito.io/v2/with/inline" async></script>

If you wish to load the widget completely unstyled you can use this instead:

<script src="https://js.tito.io/v2/with/inline/without/widget-css" async></script>

This is because form styles are loaded automatically in version 2. For more info and options, see form styles in the docs.

Note, if you have previously applied custom CSS for version 1 then unfortunately this CSS will need to be updated. Version 2 uses different HTML elements and therefore your previous styles will not apply correctly.

Did this answer your question?