How to Integrate OptinMonster with Joomla!

OptinMonster works on any website where you can add our embed code, including Joomla!.

In this article, you’ll learn how to integrate OptinMonster with Joomla!.

Integrate with Joomla!

After you’ve created a campaign in OptinMonster, you’ll want to embed it on your Joomla! site.

To add the embed code to your Joomla! site, follow these steps:

  1. In the OptinMonster campaign builder, navigate to the Publish view and copy the Global Embed code.
    Copy the embed code for your OptinMonster campaign from the Publish screen of the campaign builder.
  2. Next, log into your Joomla! site and navigate to the Plugin Manager section.
  3. Select the Editor – TinyMCE plugin to edit it.
    To edit your Tiny MCE Plugin, first select the Plugin Manager link.
  4. On the edit screen, scroll down to the Prohibited Elements setting. By default, this field will contain script, applet, iframe.
    You’ll need to remove script from this field so the OptinMonster embed code will work on your site. It should look like the image below after the change.
    You'll need to prevent your text editor from removing script tags.
  5. Next, navigate to the Module Manager page and select the New button.
    To embed your campaign you'll need to create a new Module.
  6. Select Custom HTML as the Module Type you wish to add.
    Select Custom HTML when adding a new Module.
  7. Give your Custom HTML Module a Title to easily identify it, then from the TinyMCE toolbar select Tools > Source Code.
    You'll want to add your embed code using the Source Code campaign when creating your Module in Joomla!
  8. In the modal window that appears, paste the OptinMonster embed code and select Ok when you’re finished.
    You can paste your campaign embed code into the Source Code modal when creating your Custom HTML Module.
  9. (Optional) Set the Module’s Title to Hide in the sidebar options unless you specifically want to show the Title.
  10. If you are adding any popup type OptinMonster campaign we recommend configuring the Module Position to Footer. If this is an Inline type campaign the Position should be set to whatever location you want the campaign to visually appear in.
    You can control the position of your campaign on the page depending on if you're displaying a popup campaign or inline.
  11. When you’re finished, click Save.

Troubleshooting

What domain do I enter when creating my campaign?

If you’re using the hosted version of Joomla! you can add the domain joomla.com for your campaign to load on. This will allow you to view the campaign when previewing your site.

If your site uses a custom domain, you’ll need to also add the domain that appears in the address bar when you view your website.

If you haven’t registered the domain you want to use in your OptinMonster account yet, you can add the site through the Publish screen in the campaign builder, or through the Account > Sites screen. Learn more about how to register your domain in OptinMonster.

  1. In the Publish view of the campaign builder, be sure the domain is listed under the Websites section. Click Add a website if your domain isn’t already assigned to the campaign to select and add it.
    Add site to the Publish screen for your OptinMonster campaign.
  2. When you’re finished, click Save.