> ## Documentation Index
> Fetch the complete documentation index at: https://requestly-mintlify-changelog-requestly-past-week-38456.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Rules Not working

> Having trouble with your rules? Follow this step-by-step checklist to quickly identify and resolve common issues with the Requestly browser extension.

## 1. Confirm Extension Permissions

<Steps>
  <Step title="Open Extension Settings">
    Go to `chrome://extensions/` in your browser.
  </Step>

  <Step title="Access Requestly Details">
    Find the Requestly extension and click **Details.**

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/mXCJH8C7nLZtMWyJ/images/rules-not-working/1e42a891-b028-499c-88f2-3f16a994f3aa.png?fit=max&auto=format&n=mXCJH8C7nLZtMWyJ&q=85&s=ded04e367c4ad7d0d7eff1e0cf65e3cd" align="center" fullwidth="false" width="2396" height="1372" data-path="images/rules-not-working/1e42a891-b028-499c-88f2-3f16a994f3aa.png" />
  </Step>

  <Step title="Set Site Access">
    Under **Site access**, choose **"On all sites"**.

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/mXCJH8C7nLZtMWyJ/images/rules-not-working/5ec26ed8-5e34-442c-9995-67559326a40a.png?fit=max&auto=format&n=mXCJH8C7nLZtMWyJ&q=85&s=e51ace8647af339be92e1609341b57b7" align="center" fullwidth="false" width="2396" height="1372" data-path="images/rules-not-working/5ec26ed8-5e34-442c-9995-67559326a40a.png" />
  </Step>
</Steps>

## 2. Ensure the Extension Is Enabled

<Steps>
  <Step title="Open Extension Page">
    Go to `chrome://extensions/`
  </Step>

  <Step title="Check the Toggle">
    Make sure the toggle for Requestly is **enabled** (blue).

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/mXCJH8C7nLZtMWyJ/images/rules-not-working/0e737992-174a-4319-9c1b-c9de72919f21.png?fit=max&auto=format&n=mXCJH8C7nLZtMWyJ&q=85&s=edfc281d6ca29db4f6d8540ff8819fe1" align="center" fullwidth="false" width="2396" height="1372" data-path="images/rules-not-working/0e737992-174a-4319-9c1b-c9de72919f21.png" />
  </Step>
</Steps>

## 3. Check If the Rule Group Is Active

Groups allow you to organize rules into logical groups and enable/disable them in one go.

<Steps>
  <Step title="Open the Dashboard">
    Visit the <a target="_blank" href="https://app.requestly.io/">Requestly dashboard</a>.
  </Step>

  <Step title="Locate Your Rule Group">
    Find the group that contains your rule.
  </Step>

  <Step title="Activate the Group">
    Make sure the toggle for that group is switched **on**

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/mXCJH8C7nLZtMWyJ/images/rules-not-working/366cd164-d8d2-44be-8609-a1a8361a723c.png?fit=max&auto=format&n=mXCJH8C7nLZtMWyJ&q=85&s=d703bd33a0ea3bf7cdb40ac5ea21528f" align="center" fullwidth="false" width="2396" height="1372" data-path="images/rules-not-working/366cd164-d8d2-44be-8609-a1a8361a723c.png" />
  </Step>
</Steps>

## 4. Activate the Extension (If Disabled)

<Steps>
  <Step title="Open Requestly Popup">
    Locate and click the Requestly icon in your browser’s toolbar to open the menu.

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/mXCJH8C7nLZtMWyJ/images/rules-not-working/91587b36-aa09-4918-8d8e-5b658b45eeaf.png?fit=max&auto=format&n=mXCJH8C7nLZtMWyJ&q=85&s=b3a1ff970dd0b4e0c39e91d41bae661c" align="left" fullwidth="false" width="2400" height="1488" data-path="images/rules-not-working/91587b36-aa09-4918-8d8e-5b658b45eeaf.png" />
  </Step>

  <Step title="Enable Requestly">
    Click the Requestly icon in your browser’s toolbar and find the toggle labeled "Requestly paused." Click the toggle to activate Requestly. The label will change to "Requestly running," confirming activation.

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/mXCJH8C7nLZtMWyJ/images/rules-not-working/88f3b0fe-7f2c-43e5-8d33-a1541dc15b43.png?fit=max&auto=format&n=mXCJH8C7nLZtMWyJ&q=85&s=5dc5440e9977d6421109ff00e5df8c81" align="left" fullwidth="false" width="2400" height="1488" data-path="images/rules-not-working/88f3b0fe-7f2c-43e5-8d33-a1541dc15b43.png" />
  </Step>

  <Step title="Refresh the Page">
    Refresh your browser page to ensure that Requestly’s rules are properly applied.
  </Step>
</Steps>

## **Common Issues by Rule Type**

> Some rule types in Requestly have specific behaviors or limitations. Here's what you need to know for each one:

### Modify API Response

**Not visible in Chrome DevTools**\
API response modifications made by Requestly don’t show up in the browser’s DevTools, but they’re still applied in the background.

**Only works with XHR/Fetch requests**\
Modify API Response **can’t modify** HTML, CSS, or other static files in the extension. For that, use the [Desktop App](https://requestly.com/downloads/desktop/).

### Modify Response Headers

Response Headers modification done by Requestly are not visible in Browsers devtool but they are actually modified.

### Delay Request

In the browser extension, delays are automatically capped to prevent performance issues. XHR/Fetch requests can be delayed up to 5,000 ms, while other resources (like JS, CSS, images) support up to 10,000 ms. For unlimited delays, switch to the <a target="_blank" href="https://requestly.com/downloads/desktop/">Desktop App</a>.

### Insert Script Rule

**Inline JavaScript is ignored when using the URL option**\
When you choose the **URL** method, only the external script is loaded. Any inline JavaScript written between the `<script>` tags will be completely ignored by the browser

**Doesn’t run on internal browser pages**\
Scripts won’t run on pages like `chrome://`, [`file://`](file://), or other system-level pages. For testing, use a local server or the **Desktop App**.

## Still Stuck?

If you’ve walked through all the above and the issue persists, reach out to the team at [contact@requestly.io](mailto:contact@requestly.io) **.**
