Skip to content

Commit 4ebb4da

Browse files
authored
workflows: draft pricing updates
1 parent f6e7169 commit 4ebb4da

File tree

1 file changed

+25
-4
lines changed

1 file changed

+25
-4
lines changed

src/content/docs/workflows/reference/pricing.mdx

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,28 +16,49 @@ Workflows is included in both the Free and Paid [Workers plans](/workers/platfor
1616

1717
:::
1818

19-
Workflows pricing is identical to [Workers Standard pricing](/workers/platform/pricing/#workers) and are billed on two dimensions:
19+
Workflows pricing is identical to [Workers Standard pricing](/workers/platform/pricing/#workers) and are billed on three dimensions:
2020

2121
* **CPU time**: the total amount of compute (measured in milliseconds) consumed by a given Workflow.
2222
* **Requests** (invocations): the number of Workflow invocations. [Subrequests](/workers/platform/limits/#subrequests) made from a Workflow do not incur additional request costs.
23+
* **Storage** (stored state): the total amount of state persisted by your Workflow instances.
24+
25+
### Workflows pricing
26+
27+
28+
| | Requests<sup>1, 2</sup> | Duration | CPU time | Storage | |
29+
| ------------ | ------------------------------------------------------------------ | ------------------------------- | ------------------------------------------ | -------------------------------- |
30+
| **Free** | 100,000 per day | No charge for duration | 10 milliseconds of CPU time per invocation | 1GB total storage | |
31+
| **Standard** | 10 million included per month <br /> +$0.30 per additional million | No charge or limit for duration | 30 million CPU milliseconds included per month<br /> +$0.02 per additional million CPU milliseconds<br /><br/> Max of 30 seconds of CPU time per invocation | 5 GB-month, + $0.20/ GB-month |
2332

2433
A Workflow that is waiting on a response to an API call, paused as a result of calling `step.sleep`, or otherwise idle, does not incur CPU time.
2534

35+
### Storage Usage
36+
37+
Storage is billed using gigabyte-month (GB-month) as the billing metric, identical to [R2](/r2/pricing/#storage-usage) and the [Durable Objects SQL storage](/durable-objects/platform/pricing/#sqlite-storage-backend). A GB-month is calculated by averaging the peak storage per day over a billing period (30 days).
38+
39+
* Storage is calculated across all instances, and includes running, errored, sleeping and completed instances.
40+
* By default, instance state is retained for [3 days on the Free plan](/workflows/reference/limits/) and [7 days on the Paid plan](/workflows/reference/limits/).
41+
* When creating a Workflow instance, you can set a shorter state retention period if you do not need to retain state for errored or completed Workflows.
42+
* Deleting instances via the [Workers API](/workflows/build/workers-api/), [wrangler CLI](/workers/wrangler/commands/#workflows), REST API or dashboard will free up storage. Note that it may take a few minutes for storage limits to update.
43+
44+
An instance that attempts to store state when your have reached the storage limit on the Free plan will cause a `WorkflowsStorageExceeded` error to be thrown.
45+
2646
## Frequently Asked Questions
2747

2848
Frequently asked questions related to Workflows pricing:
2949

3050
### Are there additional costs for Workflows?
3151

32-
No. Workflows are priced based on the same compute (CPU time) and requests (invocations) as Workers.
52+
No. Workflows are priced based on the same compute (CPU time) and requests (invocations) as Workers, as well as stored state.
3353

3454
### Are Workflows available on the [Workers Free](/workers/platform/pricing/#workers) plan?
3555

36-
Yes.
56+
Yes. Workflows shares the same daily Free plan [limits](/workers/platform/pricing/#workers) with Workers.
3757

3858
### How do Workflows show up on my bill?
3959

40-
Workflows are billed as Workers, and share the same CPU time and request SKUs.
60+
* For CPU time and requests: Workflows will show up as Workers, as they the same CPU time and request SKUs.
61+
* For storage: Workflows will show up as "Workflows - Storage (GB-mo)".
4162

4263
### Are there any limits to Workflows?
4364

0 commit comments

Comments
 (0)