# Marketing Message Frequency Capping

You’ll find this under **Settings** **→ Channels → WhatsApp → Advanced Settings → Message Capping**.

## What is Message Capping?

Message Capping allows you to define the maximum number of messages that can be sent to a single user within a defined time period.

There are **two types of message caps** you can control:

1. **Marketing Messaging Capping**\
   Limits promotional or marketing broadcast messages.
2. **Utility Fallback Message Capping**\
   Limits automated fallback messages that are triggered if a delivery fails or requires retry via Utility Fallback Message.

## How to set the Marketing Message Frequency Cap?

{% tabs %}
{% tab title="Video Tutorial" %}
{% embed url="<https://youtu.be/VQFrpSsDHz8>" %}
{% endtab %}

{% tab title="Step-by-Step Instructions" %}
{% hint style="info" %}
This process shows how to limit the number of WhatsApp marketing and utility fallback messages sent to a single user within a defined time period, helping you avoid over‑messaging and reducing spam.
{% endhint %}

{% stepper %}
{% step %}

### Open Profile Settings

From the left navigation menu, go to **Profile View** and click on it.\
In the Profile View, locate **Settings** and click on it to open the configuration options.
{% endstep %}

{% step %}

### Access WhatsApp Channel Configuration

In the Settings area, you will see a list of all connected channels. Select **WhatsApp** to open its specific configuration options.
{% endstep %}

{% step %}

### Open Advanced Settings for WhatsApp

Within the WhatsApp configuration page, scroll down to the bottom.\
Locate the **Advanced Settings** section and expand it.\
In Advanced Settings, find the **Message Capping** option, which may currently be unset.\
Click **Change** to modify the message capping configuration.

<figure><img src="/files/qVF3zVi96OZQ5rrgRleK" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Enable and Configure Marketing Message Capping

Enable the **Marketing Message Capping** option.\
Define the maximum number of marketing messages allowed per user within your chosen time frame. For example, set it to send a maximum of **4 messages per user every 7 days**.

<figure><img src="/files/QOlouomdInmz9D4BWTPb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Configure Utility Fallback Message Frequency

In the same section, locate the settings for **utility fallback messages** (messages that are triggered when a marketing message fails). Enable and configure the frequency cap for these utility fallback messages as well. For example, you may choose to send a maximum of **1 message per user per day**.

<figure><img src="/files/nPFpUuSrHqwItIMAug9Y" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Review and Save the Frequency Cap

Review your configured limits for both marketing and utility fallback messages to ensure they align with your communication policy and compliance requirements.\
This completes the setup of your marketing message frequency cap.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

## Why should you use Message Capping?

Message Capping is useful when you want to:

* Avoid sending too many messages to the same user within a short time.
* Improve customer experience and prevent spam complaints.
* Stay compliant with various data-privacy and jurisdiction-based messaging rules.
* Maintain a clean sender reputation to avoid opt-outs.

## Where does this apply?

Message capping applies across all marketing messages triggered via any mode - Broadcasts, Campaigns, Journeys,  APIs or manual messages. If the limit is reached within the configured time window—**that message will be skipped automatically**.

## What happens when caps are OFF?

If the toggle is disabled:

* There are **no limits**
* The system will send all scheduled messages

By default, capping is turned **OFF** until you enable it.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.quickreply.ai/product-modules/settings/channels/whatsapp/marketing-message-frequency-capping.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.