Welcome to our guide on using the Script Removal App. If your site relies on plugins that inject scripts to insert ads, it's crucial to remove these ads on Ezoic versions of your site to ensure accurate testing results. This article will provide you with step-by-step instructions on how to set up and use the Script Removal App effectively. You'll learn how to enable script removal, add scripts to be removed, and manage scripts you wish to keep. By the end of this guide, you'll have the knowledge to maintain a clean, test-friendly version of your site on Ezoic.

1. Go to the Settings tab of your Ezoic dashboard. 

2. Go to the Content section.

3. Select the Script Removal tab and click on 'enable script removal'.
   

4. Click "Settings".

5. Click “Add To Removed Scripts”.

6. Give the script a name - this is something that you can recognize it by.

7. Add a regex to uniquely identify the script. A Regular Expression, or Regex, is a special text string for describing a search pattern.

   • Example: If you want to remove any scripts containing "yellow" from your site, then you would submit the following:
     • Script Name = Yellow
     • Script Regex = yellow  
       • 

8. You can also make more dynamic patterns:

   • Example: If Script Regex = green/[abc], any script containing green/a, green/b, or green/c will be removed. But a script containing green/f would stay.

9. To test your regex, go to regex101.com. Place the scripts you wish to remove inside of Test String, then enter your Script Regex in Regular Expression. If there is a match, then it will be removed.

10. One way to find the script:

    • Right click and inspect the element on your website to bring up the ad code in Chrome Developer Tools.
    • Search for the URL of the network or the Content Delivery Network.
    • Look for something succinct which uniquely identifies that particular code.

     

11. Note: Do not add common expressions as this may tell our system to remove other parts of the page on Ezoic versions.

12. It can take approximately an hour after adding the script to the app before you’ll see changes on the site.

13. If the ad is not removed correctly, try:

    • Clearing cache and cookies.
    • Amending the unique identifier in the “regex” field.

Scripts you want to keep?

If there are scripts you want to keep, you can:

1.  Request to keep scripts removed by default (such as Taboola or Amazon scripts) within the app by clicking “keep” next to each script. 

       2. You will then be prompted to submit a reason for keeping a script. To submit, click "Keep Script".

Common issues users may encounter when setting up script removal include:

1. Script Not Removed Correctly:
   • Solution:
     1. Ensure that the regex pattern is accurate and uniquely identifies the script you wish to remove.
     2. Clear your browser cache and cookies to see the changes.
     3. If the problem persists, try amending the unique identifier in the "regex" field.
2. Changes Not Reflected Immediately:
   • Solution:
     1. Be aware that it can take approximately an hour after adding the script to the app before changes are visible on the site.
     2. Patience may be required as the system processes the changes.
3. Accidental Removal of Wanted Scripts:
   • Solution:
     1. Avoid adding common expressions in the regex as this may cause the removal of other necessary parts of the page in Ezoic versions.
     2. If certain scripts are removed by default but you want to keep them, use the "keep" option next to each script in the app.
     3. Submit a valid reason for keeping the script to complete this request.
4. Finding the Correct Script to Remove:
   • Solution:
     1. Right-click and inspect the element on your website to bring up the ad code in Chrome Developer Tools.
     2. Search for the URL of the network or the Content Delivery Network to find identifiers.
     3. Ensure the identifier is succinct and uniquely identifies the particular script to avoid unintended script removal.

If you need further assistance with the Script Removal app, please log in via https://support.ezoic.com/ to make use of our dedicated resources for support. We're here to help!