> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-user-guide.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequency capping

# Overview

Frequency capping (FC) lets you control your campaign's communication frequency with users. This significantly prevents customers from receiving bursts of communication from multiple channels simultaneously and improves user engagement and brand value in the market.

You can configure Frequency capping in two ways,

* **Channel and Campaign Delivery:** You can configure frequency capping for your campaign's communication based on delivery types, such as one-time, event-triggered, etc., from any channel.
* **Tag-based Frequency capping:** You can configure frequency capping for your campaign's communication with **tags** such as promotional, engagement, etc., which allows you to control the communication of your campaigns that have the tags you selected.

## Channels Supported for Campaign Delivery Type-based FC and Tag-based FC

| Channel name      | Campaign Delivery types                                                                                                                  | Supported for Delivery type FC | Supported for Tag-based FC |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | -------------------------- |
| Push              | <ul><li>One time/Periodic</li><li>Event triggered</li><li>Device triggered</li><li>Location triggered</li><li>Flows - Push API</li></ul> | Yes                            | Yes                        |
| SMS, MMS & RCS    | <ul><li>One time/Periodic</li><li>Event triggered</li><li>Flows (SMS only)</li></ul>                                                     | Yes                            | Yes                        |
| Email             | <ul><li>One time/Periodic</li><li>Event triggered</li><li>Flows</li></ul>                                                                | Yes                            | Yes                        |
| WhatsApp          | <ul><li>One time/Periodic</li><li>Event triggered</li><li>Flows</li></ul>                                                                | Yes                            | Yes                        |
| Connector         | <ul><li>One time/Periodic</li><li>Event triggered</li><li>Flows</li></ul>                                                                | Yes                            | Yes                        |
| In-App            | <ul><li>On Session start</li><li>On Screen load</li><li>On Custom Event - Flows</li></ul>                                                | Yes                            | Yes                        |
| On-Site Messaging | <ul><li>On Page load</li><li>On Exit Intent</li><li>On Custom Event</li></ul>                                                            | Yes                            | Yes                        |

## Configure Frequency Capping

The Frequency Capping settings page is divided into **Outbound Channels** and **Inbound Channels**. You can configure FC for multiple channels and delivery types within their respective sections.

<Info>
  The frequency capping you configure applies only to the upcoming campaigns and does not affect existing ones.
</Info>

1. Log in to the MoEngage dashboard.
2. On the left navigation menu in the MoEngage dashboard, select **Settings > Channels.**
3. In the **Channels** section, select **Delivery controls.**
4. On the **Delivery controls** page, click the **Frequency capping** tab.
5. The page is divided into **Outbound Channels** (Push, SMS, Email, etc.) and **Inbound Channels** (In-App, On-Site Messaging). Navigate to the desired section to configure the rules.

You can set frequency capping values for outbound channels either globally using **cross-channel configuration** or for individual channels. Inbound channels have their own dedicated configuration sections.

## Configure FC in Outbound Channels

For outbound channels, you can configure FC globally or for each channel specifically. Cross-channel configuration only applies to outbound channels.

* **Cross-channel configuration:** Turn on the **All channels** toggle and specify the limit for the number of communications that must be sent to users from all channels. This is the maximum limit for the total number of communications that must be sent to a customer within the specified number of days. For example, if you set the cap at four communications in 6 days, you can send only four communications in total from all the channels in the next 6 days. This is performed on a first-come, first-served basis.

<Tabs>
  <Tab title="Push">
    To enable Frequency capping for the Push notifications:

    * Turn on the **Push** toggle.
    * Enter the maximum number of communications you wish to send over a specified number of days (for example, two push notifications in one day). This configuration applies to all **Push** campaigns by default. For example, if the FC for **Push** is set as six communications for the next 6 days, a maximum of six communications are sent in the next 6 days. This is done on a first-come, first-served basis.
    * To set FC based on the campaign's delivery type, add a rule below by clicking the plus sign (+) at the end of each configuration and configure the delivery type to one time/periodic, event triggered, etc.
    * You can configure FC based on tags by adding another rule with the option, **select from** *campaigns with any/all of the selected tags* and select the tags to send communications accordingly.

    Example: To send only six **Push** communications to your users in the next 6 days from **all push campaigns** and send only two push notifications in the next 6 days from *campaigns with all the selected tags (Tags: all users, engagement, and promotion)* and not more than twice to the users from location-triggered campaigns in the next 6 days, you can set frequency capping as follows.

    1. Send a maximum of 6 Web and App push from all push campaigns to a user in 6 days.
    2. Send a maximum of 2 Web and App push from all campaigns with all the selected tags (Tags: all users, engagement, promotion) to a user in 6 days.
    3. Send a maximum of 2 Web and App pushes from location-triggered campaigns to a user in 6 days. <img src="https://mintcdn.com/moengage-user-guide/H22WAnH-0jcPGgEa/images/moengage_f174bb.png?fit=max&auto=format&n=H22WAnH-0jcPGgEa&q=85&s=372b6b542b38c9cadc47e82a5afc7a1d" width="2260" height="596" data-path="images/moengage_f174bb.png" />

    ### Working of FC in Push

    Frequency capping limits the number of push notifications a user receives within a specified timeframe, based on the platform they are using. This capping operates at the user and platform level, not at the individual device level.

    For example, consider a frequency cap set at two notifications over two days, the configuration will be:

    * Android: 2 notifications
    * iOS: 2 notifications
    * Web: 2 notifications

    Scenario:

    * If a campaign targets Android, iOS, and Web, a user receives 1 notification per platform on Day 1. The frequency cap for each platform then reduces to 1.
    * If a subsequent campaign targets only Android and iOS on Day 2, users receive 1 notification per platform, assuming the two-day cap hasn't been reached for those platforms from other campaigns.
    * If a campaign later targets Android and Web, only Web users receive a notification if the Android frequency cap for that user was already met by previous campaigns within the two-day window.

    <Info>
      If a user has multiple devices on the same platform (e.g., three Android devices) and the frequency cap is one per day, each of their Android devices may still receive one notification.
    </Info>
  </Tab>

  <Tab title="SMS, MMS, & RCS">
    To configure Frequency capping for the SMS,MMS & RCS:

    * Turn on the **SMS, MMS & RCS** toggle.
    * Enter the maximum number of **SMS,MMS & RCS** you wish to send over a specified number of days (for example, one message in one day).
    * If the FC for **SMS, MMS & RCS** is set to three for the next 7 days, a maximum of three communications can be sent in those 7 days. This is done on a first-come, first-served basis.
    * This configuration applies to all **SMS, MMS & RCS** campaigns by default. By adding a rule below by clicking the plus sign (+) at the end of each configuration, you can configure FC based on campaign delivery type, such as one time or event triggered.
    * While configuring the **SMS, MMS & RCS** campaign, you can set FC based on tags by adding another rule with the option to select from campaigns with (any/all) of the selected tags and select the tags to send communications accordingly.

    Example: To send **SMS, MMS & RCS** to your users thrice a week and only twice from the *campaigns* with *all the selected tags (Tags: engagement, promotion)*, you can set frequency capping as follows.

    1. Send a maximum of 3 SMS, MMS & RCS from all SMS, MMS & RCS campaigns to a user in 7 days.
    2. Send a maximum of 2 SMS, MMS & RCS from the campaign with all the selected tags (Engagement, promotion) to a user in 7 days. <img src="https://mintcdn.com/moengage-user-guide/8Ml9Ic0RRLLTTfx5/images/moengage_b579a3.png?fit=max&auto=format&n=8Ml9Ic0RRLLTTfx5&q=85&s=2a1e6fc4a38ca803bc00030897e9e7a5" alt="FC.png" width="2196" height="202" data-path="images/moengage_b579a3.png" />
  </Tab>

  <Tab title="Email">
    To configure Frequency capping for the Email:

    * Turn on the **Email** toggle.
    * Enter the maximum number of Emails you wish to send over a specified number of days (for example, five Emails in 6 days).
    * If the FC for **Email** is set to five for the next 6 days, a maximum of five communications can be sent in those 6 days. This is done on a first-come, first-served basis.
    * This configuration applies to all **Email** campaigns by default. By adding a rule below by clicking the Plus sign (+) at the end of each configuration, you can configure FC based on campaign delivery type, such as one time, event triggered, etc.

    Example: To send five **Email** communications to the users from all email campaigns and not more than three **Email** communications to the users from an *event triggered campaign* in the next 6 days. You can set the frequency capping as follows.

    1. Send a maximum of 5 Emails from all email campaigns to a user in 6 days.
    2. Send a maximum of 3 Emails from an event-triggered campaign to a user in 6 days. <img src="https://mintcdn.com/moengage-user-guide/pPpveGyRjztmmozC/images/moengage_866130.png?fit=max&auto=format&n=pPpveGyRjztmmozC&q=85&s=3943d4ceecca273b5348f9f09f12b801" width="2238" height="326" data-path="images/moengage_866130.png" />
  </Tab>

  <Tab title="WhatsApp">
    To configure Frequency capping for the WhatsApp:

    * Turn on the **WhatsApp** toggle.
    * Enter the maximum number of WhatsApp messages you wish to send over a specified number of days (for example, one message in 2 days).
    * If the FC for **WhatsApp** is set to four for the next 6 days, a maximum of four communications can be sent in those 6 days. This is done on a first-come, first-served basis.
    * This configuration applies to all **WhatsApp** campaigns by default. By adding a rule below by clicking the plus sign (+) at the end of each configuration, you can configure FC based on campaign delivery type, such as one time, event triggered, etc.

    **Example:** To send a maximum of four **WhatsApp** communications from **all** **WhatsApp** campaigns in the next 6 days, two from *one time/periodic campaign*, you can set the frequency cap as follows.

    1. Send a maximum of 4 WhatsApp messages from all WhatsApp campaigns to a user in 6 days.
    2. Send a maximum of 2 WhatsApp from one/time periodic campaign to a user in 6 days <img src="https://mintcdn.com/moengage-user-guide/9ksPkI9hfH5e6Dgf/images/moengage_bcdb55.png?fit=max&auto=format&n=9ksPkI9hfH5e6Dgf&q=85&s=2b7a5635ba9dab58d69277f3de967df6" width="2260" height="348" data-path="images/moengage_bcdb55.png" />
  </Tab>

  <Tab title="Connector">
    To configure Frequency Capping for Connectors:

    * Turn on the **Connector** toggle.
    * Enter the maximum number of messages you wish to send over a specified number of days (for example, three messages in 2 days).
    * If the cross-channel FC is set to three for the next 5 days, a maximum of three communications can be sent in those 5 days. This would be done on a first-come, first-served basis.
    * This configuration applies to all connector campaigns by default. By adding a rule below by clicking the Plus sign (+) at the end of each configuration, you can configure FC based on campaign delivery type such as one time, event triggered, etc.
    * While configuring the **Connectors**, you can set FC for campaigns based on delivery types. By adding another rule with the option *select form campaigns with (any/all) of the selected tags,* you can send communications to the selected tags.

    Example: To send a maximum of six communications from **all Connector** campaigns, two communications from *one-time/periodic campaigns,* and two communications from *campaigns with any of the selected tags (activation, engagement, promotion)* in the next 6 days, you can set the frequency cap as follows.

    1. Send a maximum of 6 Connector requests from all Connector campaigns to a user in 6 days.
    2. Send a maximum of 2 Connector requests from an event-triggered campaign to a user in 6 days.
    3. Send a maximum of 2 Connector requests from campaigns with any of the following tags. (Tags: activation, engagement, promotion) to a user in 6 days.
  </Tab>
</Tabs>

## Configure FC in Inbound Channels

Frequency capping for inbound channels (In-App and On-Site Messaging) helps you control how often users see messages in your app or on your website. You must configure the rules for each channel, based on trigger types and tags.

<img src="https://mintcdn.com/moengage-user-guide/Kch8a9R_vRsrkgut/images/moengage_713bac.png?fit=max&auto=format&n=Kch8a9R_vRsrkgut&q=85&s=4189906f18787554600b8082ad188525" alt="Screenshot 2025-10-22 at 12.21.39 PM.png" width="3192" height="1402" data-path="images/moengage_713bac.png" />

<Tabs>
  <Tab title="In-App">
    To configure Frequency Capping for In-App messages:

    1. In the **Inbound Channels** section, turn on the **In-App** toggle.
    2. A default rule is present to cap messages from **all In-App campaigns**. You can set the maximum number of messages a user receives in a given **session**, **hour(s)**, or **day(s)**. The duration uses a rolling window (for example, "in the last 7 days").
    3. You can add multiple rules, which are combined using an **AND** condition. Click the plus sign (+) to add a new rule.
    4. You can create rules based on:
       * **Trigger Type**: Limit messages for specific triggers like *On Session start*, *On Screen load*, or *On Custom Event*. You can only use each trigger type once in your set of rules.
       * **Tags**: Limit messages from campaigns that have *any* or *all* of the selected tags.

    Example: To show a user a maximum of five In-App messages in 3 days, but ensure they see no more than one message per session that is triggered on a screen load.

    1. Set the default rule to: Send a maximum of **5** In-App messages from **all In-App campaigns** to a user in **3 Days**.
    2. Add a new rule: Send a maximum of **1** In-App message from **On Screen load campaigns** to a user in **1 Session**.
  </Tab>

  <Tab title="On-Site Messaging">
    To configure Frequency Capping for On-Site Messaging:

    1. In the **Inbound Channels** section, turn on the **On-Site Messaging** toggle.
    2. A default rule is present to cap messages from **all On-Site Messaging campaigns**. You can set the maximum number of messages a user receives in a given **session**, **hour(s)**, or **day(s)**.
    3. Add more granular rules using the plus sign (+). All rules are combined with an **AND** condition.
    4. You can create rules based on:
       * **Trigger Type**: Limit messages for specific triggers like *On Page load*, *On Exit Intent*, or *On Custom Event*. Each trigger type can only be used once.
       * **Tags**: Limit messages from campaigns associated with specific tags.

    Example: To show a maximum of 3 on-site messages per day, and ensure that promotional messages are only shown once per week.

    1. Set the default rule to: Send a maximum of three On-Site messages from **all On-Site Messaging campaigns** to a user in **1 Day**.
    2. Add a new rule: Send a maximum of **1** On-Site message from campaigns with **any of the selected tags (Tag: promotion)** to a user in **7 Days**.
  </Tab>
</Tabs>

## Applying FC in Different Scenarios

| Scenario                                                                                                                                                                                                                                                                                                                                | Configuration                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Scenario 1: Outbound, based on campaign delivery type**<br />Let's assume you want to send a maximum of six communications from Push for an upcoming week. Not more than three communications from one time/periodic campaigns and not more than three communications from event triggered campaigns via Push.                        | The configuration for scenario 1 is as follows: <ol><li>Enable **push** and set a maximum of 6 communications from all push campaigns to a user in 7 days</li><li>Add a rule with a **maximum of 3 communications** from **Web and App Push** from **one time/periodic campaign** to a user in 7 days.</li><li>Add another rule **with a maximum of 3 communications** from **Web and App Push** from **event triggered** to a user in 7 days.</li></ol> <img src="https://mintcdn.com/moengage-user-guide/RFCZY_YJ3dCN1QG7/images/moengage_f3337d.png?fit=max&auto=format&n=RFCZY_YJ3dCN1QG7&q=85&s=afc726fdd4d9360563640d69153a731a" width="2420" height="476" data-path="images/moengage_f3337d.png" />                                                  |
| **Scenario 2: Outbound, based on tags**<br />Let's assume you want to send a maximum of 10 communications for an upcoming week. Not more than four communications from One time/periodic campaigns and not more than two communications from campaigns with all the selected tags (Tags: engagement, promotion) via Email notification. | The configuration for scenario 2 is as follows: <ol><li>Enable **Email** and set a maximum of 10 emails from **all email channels** to a user in 7 days.</li><li>Add a rule with a **maximum of 5 communications** from one **time/periodic campaign** to a user in **7 days**.</li><li>Add another rule **with a maximum of 5 communications** from **all the selected tags** (Tags: engagement, promotion) to a user in 7 days.</li></ol> <img src="https://mintcdn.com/moengage-user-guide/ujNRPNkmZCv_9CUK/images/moengage_280f66.png?fit=max&auto=format&n=ujNRPNkmZCv_9CUK&q=85&s=32f6fc2f3621938ca70f185e91fb6a88" width="2420" height="390" data-path="images/moengage_280f66.png" />                                                               |
| **Scenario 3: Outbound, FC for cross channel configuration**<br />Let's assume you want to configure a frequency cap limited to 10 communications across all channels in 7 days. Not more than four communications should be sent from campaigns with all the selected tags (promotion, engagement).                                    | The configuration for scenario 3 is as follows: <ol><li>Set a **cross channel configuration** limit to a maximum of 10 communications from **all campaigns/flows** to a user in 7 days.</li><li>Add a rule under **cross channel configuration** with a frequency cap of 4 communications **campaigns with all the selected tags** (Tags: promotion, engagement). Remaining communications are sent from any other campaign delivery types which are processed on first-come first-serve basis.</li></ol> <img src="https://mintcdn.com/moengage-user-guide/lhXvdjtPtl1U-hcS/images/moengage_95da39.png?fit=max&auto=format&n=lhXvdjtPtl1U-hcS&q=85&s=7e4dd71b477d588aa94afaa43b62221d" width="2376" height="358" data-path="images/moengage_95da39.png" /> |
| **Scenario 4: Inbound, based on trigger type**<br />Let's assume you want to limit In-App messages to a maximum of 6 per week to avoid overwhelming users. However, messages triggered by loading a specific screen are very common, so you want to limit those to only 2 per day.                                                      | The configuration for scenario 4 is as follows: <ol><li>In the **Inbound Channels In-App** section, set the default rule to a maximum of **6** communications from **all In-App campaigns** to a user in **7 days**.</li><li>Add a new rule with a maximum of **2** communications from **On Screen load campaigns** to a user in **1 day**.</li></ol>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

## Editing FC Rules

If you try to edit the tags in your frequency cap setting once it is saved, it resets the existing FC configuration, and the new FC setting is applied to the communication.

For example,

You have configured a frequency cap with a limit of four SMS & RCS communications and not more than two SMS & RCS *from campaigns with any of the selected tags(Tags: activation and promotion)* in the upcoming week. On the third day, If you try to add or remove any tags from the configuration, It resets the communication setting to zero, and the *campaigns with any of the selected tags(Tags: activation and promotion)* are eligible to receive more than two SMS & RCS communications.

## Refresh setting

Refresh setting helps you reset the frequency cap daily based on a defined timezone.

* You can reset the Frequency Cap daily at 00:00 based on your app's or user's timezone for all supported channels. By default, it refreshes at 12 AM in the app's timezone for every user. This is especially useful if you are capping messages on a daily basis. <img alt="RefreshFC.png" src="https://mintcdn.com/moengage-user-guide/-3vSwXDB0-23wJct/images/moengage_b3cc23.png?fit=max&auto=format&n=-3vSwXDB0-23wJct&q=85&s=958784e8a48dede951d86bad1ec8850e" width="910" height="302" data-path="images/moengage_b3cc23.png" />
* Click **Save**

## Delivery Controls

In [Step 3](/user-guide/campaigns-and-channels/email/create/create-an-email-campaign#step-3-schedule-and-goals) (Schedule and Goals) of campaign creation for any channel (including In-App and On-Site Messaging), you can configure the delivery controls for your frequency capping.

<img src="https://mintcdn.com/moengage-user-guide/0aMghOeJ2wfLjro2/images/moengage_ad638e.png?fit=max&auto=format&n=0aMghOeJ2wfLjro2&q=85&s=dac4d1cd6b6ab6f52df37d2e6b469c33" alt="Screenshot 2025-01-09 at 3.15.35 PM.png" style={{ width:"65%" }} width="688" height="204" data-path="images/moengage_ad638e.png" />

**Ignore frequency capping:**

To send important communications (for example, a service outage announcement) irrespective of your frequency cap setting, turn on the **Ignore frequency capping** toggle under the **Delivery Controls** section.

**Count for frequency capping:**

When a campaign is set to ignore frequency capping, you can still have it count towards the cap for other campaigns. Turn on the **Count for the frequency capping** toggle to ensure this message is included when calculating the frequency cap for subsequent messages.