Install Yaplet on Magento (Adobe Commerce)

Updated October 22, 2026

Magento Open Source and Adobe Commerce have a footer setting for scripts that load just before the end of every page, and that is all the Yaplet widget needs. You copy one block of code from Yaplet, paste it into that setting, refresh the cache, and the chat button appears in your store. You don't need an extension.

These steps are for stores that run on your own servers or on Adobe Commerce on cloud infrastructure; Adobe's guide for this setting covers those two setups. On Magento 2.4.7 and later, the chat won't run on the checkout pages unless a developer allows it (see below).

1. Copy your Yaplet code

In the Yaplet dashboard's left menu, go to Brand → (your brand) → Chat widget → Install. Under Where does your website run?, choose Other website. Copy the code with the copy button on the code block.

The Miscellaneous HTML field takes HTML, so the code must sit between a <script> line and a </script> line. With Other website chosen, the code already has these lines, because the switch Include the <script> and </script> lines is on. If you turned that switch off, the code is plain JavaScript that starts with !function (Yaplet, and you add the lines in step 3.

2. Open the footer settings

In the Admin sidebar, go to Content → Design → Configuration. Find the store view where you want the chat and click Edit in the Action column. Under Other Settings, expand the Footer section.

3. Add the Yaplet code

  1. Click into the Miscellaneous HTML field. If it already has code, go to the end and start a new line. Leave the existing code as it is.
  2. Paste the Yaplet code on the new line. It must start with a <script> line and end with a </script> line. If what you copied starts with !function (Yaplet instead, type <script> on a new line before it and </script> on a new line after it.
  3. Click Save Configuration.
  4. If your store has more than one store view, repeat these steps for each store view where you want the chat.

4. Refresh the cache

If Magento shows a message that a cache needs a refresh, click the Cache Management link in it (or go to System → Tools → Cache Management). Select the caches marked as invalid, set Actions to Refresh, and click Submit. You can also click Flush Magento Cache.

5. Check your store

Open your store in a new browser tab and reload the page. The Yaplet chat button appears in the bottom-right corner. Click it to check that the chat opens.

For a full checklist, see Verify your installation.

The checkout pages (Magento 2.4.7 and later)

From version 2.4.7, Magento's Content Security Policy runs in "restrict" mode on payment pages such as checkout: it only lets through inline scripts that are on the store's allow-list. Adobe's guide says scripts in Miscellaneous HTML don't run on checkout unless they are allow-listed. So the chat works on the rest of your store but not during checkout. If you want it there too, a developer has to add the Yaplet code and Yaplet's addresses to the allow-list in a custom module. The addresses are listed under "Content Security Policy (CSP) error" in Verify your installation.

If the chat doesn't appear

  • The code shows up as text at the bottom of your pages. The <script> tags are missing. Type <script> on a new line before the code and </script> on a new line after it, save, and refresh the cache.
  • Nothing changed after saving. The page cache still serves the old pages. Refresh the invalid caches in System → Tools → Cache Management, and clear any other page cache your store uses.
  • The chat shows on one store view but not another. The setting is saved per store view. Add the code to the other store view too.
  • The chat is missing only on checkout. That is the Content Security Policy on Magento 2.4.7 and later. See the section above.
  • Your browser shows an old copy of the page. Clearing the Magento cache doesn't clear your browser's cache. Reload the page, or open it in a private browser window.

What's next

To see what the code does and where your widget ID is, read Install Yaplet.

Did this article answer your question?