JavaScript Integration

How Do You Install ConveyThis On:

Integrating ConveyThis JavaScript widget into any website is incredibly simple. Just follow our simple, step-by-step guide to add ConveyThis to your website in just a few minutes.

Step #1

Create a ConveyThis account, confirm your email, and access your account’s dashboard.

Step #2

On your dashboard (you have to be logged in) navigate to «Domains» in the upper menu.

Step #3

On this page click “Add domain”.

There is no way to change domain name, so if you made a mistake with the existing domain name, simply delete it and create the new one.

Once you done, click to “Settings”.

*If you installed ConveyThis previously for WordPress/Joomla/Shopify, your domain name was already synced to the ConveyThis and will be visible on this page.
You can skip adding domain step and just click to «Settings» next to your domain.

Step #4

Now you are on the main configuration page.

Select source and target language(es) for your website.

Click “Save Configuration”.

Step #5

In the platform selection section, you need to choose the required platform in the technology selection field. If you haven’t found your platform, you can select “other”.

Step #6

Next, there is the domain addition and language setup section. In the “domain address” field, specify your website’s domain name. After that, you need to indicate the original language of your website and the language to which you want your website to be translated.

Step #7

Now scroll down and copy the JavaScript code from the field below.

<!-- ConveyThis code -->
<script src="//cdn.conveythis.com/javascript/conveythis-initializer.js"></script>
<script type="text/javascript">
  document.addEventListener("DOMContentLoaded", function(e) {
    ConveyThis_Initializer.init({
      api_key: "pub_xxxxxxxxxxxxxxxxxxxxxxxx"
    });
  });
</script>
<!-- End ConveyThis code -->

*Later on you may want to make some changes in the settings. To apply them you will need to make those changes first and then copy the updated code on this page.

*For WordPress/Joomla/Shopify you DO NOT need this code. For more information please refer to the instructions of the associated platfrom.

Step #8

At your website’s admin panel go to the HTML page and paste this JS code just before your </body> tag.

*If you want the button to appear on particular pages of your website, you need to place our JS in the the code of those particular pages.

Step #9

That’s it. Please visit your website, refresh the page and the language button shows up there.

Congratulations, now you can start translating your website.

*If you want to customize the button or get familiar with an additional settings, please go back to the main configuration page (with language settings) and click “Show more options”.