Page Comparison

About rate limits in CommCare

CommCare is a cloud-hosted platform engineered to provide optimal performance across all our users' project spaces. To ensure reliability, the system has built-in rate limits on the number of form submissions allowed per project space in a given period of time. 

...

What is rate limiting?

Rate Limiting is a dynamic component that enables optimal availability, scalability, and reliability in your application. Rate limiting controls the amount of data, for instance, the number of form submissions transferred to our server during a specific time.

When do rate limits apply?

Rate limits only apply when the entire CommCare platform is under high load. Your project will never experience rate limiting of form submissions during off-peak hours (as determined by real-time load patterns). CommCare applies rate limits on all project spaces when the system is under high load.

What happens when we implement rate limits?

When you submit a form from a CommCare Mobile App, and you have exceeded the rate limit, all form submissions are saved locally until the rate limit expires. All locally saved forms will be auto-synced to the server . Importantly, you when the rate limit expires.

When you submit a form from a CommCare Web App, and you have exceeded the rate limit, you are prevented from proceeding until the rate limit expires.

...

...

...

...

Please note: rate limiting applies only on SaaS CommCare environments (www.commcarehq.org and india.commcarehq.org).

Submissions that count toward form submission rate limits include:

• Form submissions via CommCare mobile and Web apps

• Form submissions via CommCare HQ APIs

• Case importer

• Automatic updates or closing of

  case

  cases via

  the Automatically

  the Automatically Update Cases feature

• Case data or Form data edits

When do rate limits apply?

Rate limits apply only when the entire CommCare platform is under high load, meaning your project will never experience rate limiting of form submissions during off-peak hours (as determined by real-time load patterns). When the system is under high load, CommCare applies rate limit caps on all project spaces.

What are the rate limit thresholds for my project space?

The rate limiting Rate limits are allocated on a per-user basis.

We determine the rate limit thresholds for your organization's project space are determined by the number of mobile workers included in your subscription plan.

In general, rate limits are allocated on a per-user basis. So, take the number of mobile workers in your space and multiply them by all of the following to find the Project Space limits respectively:

• • 230/mobile worker/week

  • 46/mobile worker/day

  • 0.14/mobile worker/minute

If your subscription is for a number of mobile workers not listed in the table, you can use the formulas listed above to calculate your exact limits.

For enterprise customers whose accounts include multiple project spaces, limits are combined across all project spaces with the total number of mobile workers included in the enterprise subscription.

• Enterprise accounts come with a dedicated submission allocation that is distributed over all the project spaces in that account.

• As long as either a project space or its Enterprise account is operating at a rate below their respective allocations, submissions for that project space will not be rate limited.

For common subscriptions with default mobile workers, please refer to the table below.

...

Standard rate limit thresholds

• The standard rate limit per minute is 0.14 form submissions per mobile worker.

• The standard rate limit per hour is 6 form submissions per mobile worker.

• The standard rate limit per day is 46 form submissions per mobile worker.

• The standard rate limit per week is 230 form submissions per mobile worker.

In the table below, you will see the calculated rate limit thresholds for each subscription plan.

(number of mobile workers) * (standard form submissions per minute or hour or day etc.)

...

...

...

...

Technically Feasible Form Submissions

We advise you to adhere to the rate limits as outlined above.

The standard rate limit threshold ratio is determined on the assumption that the CommCare user works roughly 8.5 hours a day, 5 days a week.