# Message limits

Set message limits to cap the number of messages Airship sends to a user within a time period, preventing you from over-messaging your audience.

## Project-level limits

You can set individual limits for push notifications, web push notifications, SMS, and [commercial email](https://www.airship.com/docs/developer/api-integrations/email/commercial-transactional/). Each can have more than one limit, such as 1 message per hour and 3 per day.

Limits are shared within each of these groups:

- **Scenes and In-App Automations** — One limit covers both. A Scene enabled for both app and web counts as one message, so Airship can display it in the app and on the web within the same time period. [Embedded Content](https://www.airship.com/docs/reference/glossary/#embedded_content) is excluded.

- **Sequences and Automations** — Each Automation and each message in a Sequence counts toward the limit. The limit applies to [named users](https://www.airship.com/docs/reference/glossary/#named_user), or to each channel when no named user is set.

   A message in a Sequence or Automation counts toward both the limit for its channel and the Sequence and Automation limit. For example, with push notifications limited to 1 per day and Sequences and Automations limited to 2 messages per day, a Sequence that sends 2 push notifications in one day delivers only the first.

If a user has reached the push notification limit, Airship suppresses a push notification and any in-app message sent with it from the Airship dashboard, so the user receives neither. Airship still delivers a Message Center message sent with the push notification.

### Campaign categories

You can apply a project-level message limit to a single [campaign category](https://www.airship.com/docs/reference/glossary/#campaign_categories). Every limit type except Sequences and Automations supports this. For example, a limit can cap messages in a Promotions category at 1 per day.

### Exclusions

[Message Center](https://www.airship.com/docs/reference/glossary/#message_center) messages are not limited since they only appear within your app and are less obtrusive than other notification types. The user must actively open the messages in your app to experience them.

[Silent push notifications](https://www.airship.com/docs/guides/features/messaging/push-notifications/#silent-push-notifications) are also excluded from message limits since they are not viewed by users.

### Set project message limits

Set up to 50 limits for how many messages Airship sends a user within a time period:

1. In the sidebar, select the settings icon ().
1. Under **Project settings**, select **Message Limits**.
1. Select **Add ** or **Edit 
** for the item you want to limit, then enter the maximum number of messages and a time frame of up to 72 hours or 90 days. Scenes and In-App Automations can also be set to minutes and seconds.
1. (Optional, not supported for Sequence and Automation) Select **Add a category** and choose a campaign category or create a new one.
1. Select **Add**.

### Overriding project-level limits

You can override project-level message limits for a message, so Airship sends it even if a user has reached a limit. Overriding limits suits important messages such as breaking news, account alerts, or location proximity-based messages. [Message-level limits for Sequences and Automations](#message-level-limits-for-sequences-and-automations) still apply.

Enable **Ignore Channel Message Limits** in these composer steps:

* **Message, A/B Test, and Automation:** Delivery
* **In-App Automation and Scene:** Settings

In a Sequence, enable it under **Limits** in the Sequence settings. See [Scheduling and frequency](https://www.airship.com/docs/guides/messaging/messages/sequences/create/create/#scheduling-and-frequency) in *Create a Sequence*.

In the API, set the `bypass_frequency_limits` push option to `true` in the [Push object](https://www.airship.com/docs/developer/rest-api/ua/schemas/push/#pushobject).

## Message-level limits for Sequences and Automations

You can limit the number of messages Airship sends to a user per day or in total from an Automation or a Sequence. A Sequence limit applies to each message in the Sequence individually, so a limit of 1 sends a user each message once.

When a user reaches a message-level limit on an Automation, Airship suppresses the message. When a user reaches a message-level limit on a Sequence, Airship suppresses the message and the user exits the Sequence. A user who reaches a project-level limit, including a category limit, does not exit the Sequence.

For Automations, set limits in the Setup step. See [Rule Limits](https://www.airship.com/docs/guides/messaging/messages/sequences/create-automation/#rule-limits) in *Create an Automation*.

For Sequences, set the limits in the Sequence settings. See [Scheduling and frequency](https://www.airship.com/docs/guides/messaging/messages/sequences/create/create/#scheduling-and-frequency) in *Create a Sequence*.
