Pages domain rate limits

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab Self-Managed, GitLab Dedicated

The availability of this feature is controlled by a feature flag. For more information, see the history.

You can limit how often each user can add and verify GitLab Pages custom domains. These limits apply to the UI and to the Pages domains API.

The limits are:

  • Applied independently per user.
  • Not applied per IP address.
  • Shared between project and group domains.
LimitDefaultApplies to
Domain creation20 domains each dayAdding a custom domain in the UI and with POST /projects/:id/pages/domains, and adding a group domain. Attempts that fail validation do not count toward the limit.
Domain verification5 requests every minuteVerifying a custom domain in the UI and with PUT /projects/:id/pages/domains/:domain/verify, and verifying a group domain.

Requests over a limit return 429 Too Many Requests in the API, and an error message in the UI, only when the pages_domain_rate_limits feature flag is enabled. While the flag is disabled, requests over a limit are logged but not blocked. When the flag is enabled, requests over a limit are also logged to the auth.log file.

Change the Pages domain rate limits

Prerequisites:

  • Administrator access.

To change the Pages domain rate limits:

  1. In the upper-right corner, select Admin.
  2. In the left sidebar, select Settings > Network.
  3. Expand Pages domain rate limits.
  4. Change the value of either limit. Set a limit to 0 to disable it.
  5. Select Save changes.

You can also set these limits with the application settings API, using pages_domain_create_limit and pages_domain_verify_limit.