Files
twenty/packages/twenty-docs/user-guide/workflows/capabilities/workflow-credits.mdx
T
EtienneandGitHub e68842c268 Billing - fixes (#19867)
- Uniformize credit formating : In UI, 1$=1credit. In BE 1 UI credit =
1_000_000 BE "crédits"
- Add crédit rollover information + Link to documentation +
Documentation update
<img width="291" height="317" alt="Screenshot 2026-04-17 at 18 22 59"
src="https://github.com/user-attachments/assets/2519fb9f-159d-4c85-95f4-a6e005a8a1a3"
/>
<img width="848" height="763" alt="Screenshot 2026-04-17 at 14 12 20"
src="https://github.com/user-attachments/assets/a3cc0874-f275-49ea-819f-305ec314bdfe"
/>
<img width="797" height="757" alt="Screenshot 2026-04-17 at 14 12 13"
src="https://github.com/user-attachments/assets/9048409b-d5a2-435a-b735-70370705e668"
/>

- Enable direct top-up (or subscription if in trial) from AI chat
<img width="333" height="215" alt="Screenshot 2026-04-17 at 22 52 00"
src="https://github.com/user-attachments/assets/7a20c627-2806-4bcf-a037-b45752232be9"
/>
<img width="457" height="769" alt="Screenshot 2026-04-17 at 22 51 41"
src="https://github.com/user-attachments/assets/d2a90c1b-271f-4fe9-8891-baeb2fabb86d"
/>

- Inform users if credit limit is reached - Banner
<img width="1130" height="127" alt="Screenshot 2026-04-17 at 19 15 11"
src="https://github.com/user-attachments/assets/30723e5e-c07e-462f-8eb8-e08f52bbab1c"
/>
2026-04-20 08:43:02 +00:00

75 lines
2.6 KiB
Plaintext

---
title: Workflow Credits
description: Understand workflow credit consumption and management.
---
Workflow credits power your automations in Twenty. Understanding how they work helps you optimize costs and manage your automation budget effectively.
## Credit Allocation
Workflow credits are allocated based on your billing cycle, not your plan tier:
| Billing Cycle | Credits |
|---------------|---------|
| **Monthly subscription** | 5 credits per month |
| **Yearly subscription** | 50 credits per year |
<Note>
5 monthly credits are generous for standard automations. Most teams won't exceed this limit with typical workflow usage. Additional credits are primarily needed for advanced Code actions and AI-powered workflows.
</Note>
## How Credit Consumption Works
Credits are consumed when workflows execute, not when you create them. Each workflow action consumes credits based on its complexity:
### Credit Consumption by Action Type
- **Basic internal operations**: Very low credit consumption
- Search Records
- Create Record
- Update Record
- Delete Record
- Form actions
- **Complex operations**: Higher credit consumption
- Code actions (JavaScript execution)
- HTTP Requests to external services
- **AI features**: Higher credit consumption
- AI Agent actions consume credits based on the AI model used
- More complex prompts and longer outputs use more credits
- **Delay actions**: Minimal credit consumption
- The Delay node consumes **1 credit** when it executes
- **No credits are consumed** during the wait period
- A 5-minute delay costs the same as a 5-day delay
### Real-Time Deduction
Credits are deducted in real-time as workflows execute. This means:
- Draft workflows don't consume credits
- Only active, running workflows use your credit allocation
- Failed workflows still consume credits for completed steps
## Managing Credits
### Check Credit Usage
1. Go to **Settings → Billing**
2. View your current credit consumption and remaining balance
3. Monitor usage patterns to optimize your workflows
### Purchasing Additional Credits
If you need more credits beyond your plan allocation:
1. Go to **Settings → Billing**
2. Click on the option to purchase additional credits. Packages of different sizes are available.
3. Credits are added to your current balance
## Best Practices
- **Batch Processing**: Use bulk operations and Iterator actions efficiently
- **Manual Trigger Optimization**: For manual triggers, choose `Bulk` availability to process multiple records in a single workflow run
- Optimize Code actions for efficiency
- Batch operations to reduce individual action calls