To help you track Adoption Agent usage, control costs, and prevent misuse, Userflow applies Adoption Agent limits at two levels: agent-level and global.
Privacy Assurance and Adoption Agent
Userflow does not use AI inputs to train, fine-tune, or otherwise improve public large language models. However, to maintain the highest standards of data security, we strongly recommend training your Adoption Agent on non-sensitive data and instructing users not to submit any sensitive or private information in their Adoption Agent searches. Refer to our Terms of Service for additional details.
Agent-level limits
Agent-level limits are configured in the settings for specific Adoption Agents within a single Environment (e.g., staging OR production). Usage is assessed on a rolling 30-day period.
.png)
What they control: Individual Adoption Agent usage.
Scope: Single agent in one environment (e.g., staging OR production).
When the agent-level limit is reached:
❌ That specific agent disappears from your Resource Center for 24 hours.
✅ Other Adoption Agents continue working normally.
✅ Test chats and other agent-related UI functionality remain available.
⚠️ Important: You can still accumulate usage that counts toward billing.
Additional Billing & Auto-Upgrades
Even if your agent-level limit is reached for a specific agent and it is removed from your Resource Center, you can still use other Adoption Agents and agent-related UI functions like test chats.
Note: While it's still possible to be auto-upgraded, we've built backend protections against auto-upgrades from temporary usage spikes. Consistent usage patterns over the 24-hour period are more likely to trigger an upgrade.
Global limits
Global limits apply to all Adoption Agents and are managed within the Adoption Agent UI. Usage is assessed on a rolling 30-day period and will be displayed at the top of the Adoption Agent page, allowing you to monitor your usage and adjust your global limit as needed. If your global limit is reached, all Adoption Agents and associated UI functionality that may contribute to credit counts will be deactivated for 24 hours. Global limits can be set by account owners..png)
What they control: Adoption Agent usage for all agents and agent-related UI features across your entire account in all environments.
Scope: Every agent and agent-related UI function that contributes to your credit count (e.g., test chats, staging environment activity).
When the global limit is reached:
❌ All Adoption Agents become unavailable for 24 hours.
✅ Test chats and other agent-related UI functionality remain available.
✅ No further usage accumulates (protecting you from unexpected charges).Additional Billing & Auto-Upgrades
When the global limit is reached, all of your Adoption Agents and all related UI functionality that contributes to the credit count are deactivated, reducing the possibility of additional billing or auto-upgrades.
Note: While it's still possible to be auto-upgraded, we've built backend protections against auto-upgrades from temporary usage spikes. Consistent usage patterns over the 24-hour period are more likely to trigger an upgrade.
Test chat limit
Test chat is free to use and does not count toward your subscription credits. To prevent misuse, Test chat has a separate limit of 200 credits per month, shared across your account. This limit resets based on your billing cycle — not the calendar month.
Finding your reset date
Your test credits reset on the same date your billing cycle renews. For example, if you're on an annual plan that renews on April 14, your test credits reset on the 14th of each month (April 14 → May 14 → June 14, etc.).
To find your renewal date:
Go to Settings > Billing in Userflow
Your renewal date is shown in the billing summary
If you reach the Test chat limit, Test chat will be temporarily unavailable until your next billing cycle date. Your published Adoption Agents and subscription credits are not affected.
Note: Reaching the global subscription limit does not disable Test chat. Test chat has its own separate monthly limit (described above) and remains available even when your subscription credits are exhausted.
Test chat vs. Preview
Test chat and Preview serve different purposes and are counted differently:
Test chat (Adoption Agent builder) — Does not count toward subscription credits. Covered by a separate 200-credit monthly limit that resets with your billing cycle.
Preview (flow and content preview) — Counts as regular subscription messages against your plan.
Use Test chat to verify your agent's accuracy before publishing. Be aware that Preview usage counts against your subscription plan credits.
Purchasing additional credits
If your account needs more credits than your plan includes, you can purchase additional 500-credit bundles. Contact your account team or see your billing settings for details.
Key Takeaways
Agent-level limits help you manage individual deployments, but don't prevent overall usage from growing.
Global limits act as a safety net, completely stopping Adoption Agent-related usage when reached to prevent unexpected billing or auto-upgrades.
Test chat has its own separate 200-credit monthly limit that resets with your billing cycle (not the calendar month) and is unaffected by your global subscription limit. Use Test chat to verify agent accuracy before publishing — Preview, by contrast, counts against your plan credits.
Usage calculations for both agent-level and global limits are assessed on a rolling 30-day period. If an agent or related functionality is deactivated when a limit is reached, it will be restored after 24 hours when the 30-day calculation resets.