feat(docs): Pay-per-event with usage not included disclaimer by stetizu1 · Pull Request #2229 · apify/apify-docs

stetizu1 · 2026-02-05T17:20:48Z

Resolves: https://github.com/apify/apify-core/issues/24692

Adds PPE+U to docs
Swap screenshot for current version in console

Preview for this PR was built for commit 4eeac644 and is ready at https://pr-2229.preview.docs.apify.com

Note

Low Risk
Documentation-only edits (wording and screenshots) with no runtime or API behavior changes.

Overview
Updates the Store pricing-model docs to clarify Pay per event semantics, explicitly calling out that some Actors may bill platform usage separately and adding a caution block plus an example screenshot.

Reorders/replaces screenshots in the Rental and Pay per event sections to match the current Console/Store UI and adjusts related wording/headings for clarity.

^{Written by Cursor Bugbot for commit 2bf7b28. Configure here.}

Copilot

Pull request overview

This PR updates the documentation for pay per event Actor pricing to clarify that some Actors charge platform usage separately (PPE+U model). It also replaces an outdated screenshot for rental Actors with the current console version.

Changes:

Clarified pay per event pricing model description in the pricing models list
Added a caution admonition and FAQ entry explaining that some pay per event Actors charge platform usage separately
Removed outdated rental Actor trial screenshot and consolidated to single screenshot
Added new screenshot showing pay per event with usage pricing example

Reviewed changes

Copilot reviewed 1 out of 6 changed files in this pull request and generated 1 comment.

File	Description
sources/platform/actors/running/store.md	Updated pay per event pricing documentation to explain PPE+U model and reorganized rental Actor screenshots
sources/platform/actors/running/images/store/rental-actor-trial-example.png	Removed outdated screenshot

sources/platform/actors/running/store.md

apify-service-account · 2026-02-05T17:24:28Z

Preview for this PR was built for commit 2bf7b28d and is ready at https://pr-2229.preview.docs.apify.com!

stetizu1 · 2026-02-06T09:48:41Z

Note: in followup we should

remove PPR
Maybe? move PPE to first place? I know we will still have slightly more rentals, even after PPR->E migration, but this should be our future main pricing model, we should probably "sell" it first

apify-service-account · 2026-02-06T09:56:18Z

Preview for this PR was built for commit 582a2883 and is ready at https://pr-2229.preview.docs.apify.com!

apify-service-account · 2026-02-06T10:13:21Z

Preview for this PR was built for commit 2dd61c2c and is ready at https://pr-2229.preview.docs.apify.com!

apify-service-account · 2026-02-06T10:17:27Z

Preview for this PR was built for commit 84661747 and is ready at https://pr-2229.preview.docs.apify.com!

stetizu1 · 2026-02-06T10:21:11Z

sources/platform/actors/running/images/store/free_vs_paid_actors.png

Removed

unused

apify-service-account · 2026-02-06T10:21:22Z

Preview for this PR was built for commit 4eeac644 and is ready at https://pr-2229.preview.docs.apify.com!

stetizu1 · 2026-02-06T10:21:43Z

sources/platform/actors/running/images/store/paid-actors-store.png

Removed

unused

stetizu1 · 2026-02-06T10:22:03Z

sources/platform/actors/running/images/store/paid-actors-trial.png

Removed

unused

stetizu1 · 2026-02-06T10:23:02Z

sources/platform/actors/running/images/store/pay-per-usage-actor-example.png

I actually only replaced this one, but for the sake of consistency the new one has _ instead of -... 😅

stetizu1 · 2026-02-06T10:23:33Z

sources/platform/actors/running/images/store/pay_per_result_actor_store_card.png

Removed

also obviously unused

stetizu1 · 2026-02-06T10:24:47Z

sources/platform/actors/running/images/store/rental-actor-trial-example.png

I removed this one. it does not look like this any longer and any replacement would be just duplicite with existing solution

Copilot

Pull request overview

Copilot reviewed 1 out of 15 changed files in this pull request and generated no new comments.

VojtaKai

Preapproving..replace the dashes. Otherwise looks good 👌

VojtaKai · 2026-02-10T14:01:35Z

sources/platform/actors/running/store.md

@@ -25,18 +25,16 @@ All Actors in [Apify Store](https://apify.com/store) fall into one of the four p

 1. [**Rental**](#rental-actors) - to continue using the Actor after the trial period, you must rent the Actor from the developer and pay a flat monthly fee in addition to the costs associated with the platform usage that the Actor generates.
 2. [**Pay per result**](#pay-per-result) - you do not pay for platform usage the Actor generates and instead just pay for the results it produces.
-3. [**Pay per event**](#pay-per-event) - you can run the Actor and you do not pay for platform usage the Actor generates. Instead you pay for the specific events the Actor creator defines, such as for generating a single result or starting the Actor.
+3. [**Pay per event**](#pay-per-event) - you pay for specific events the Actor creator defines, such as generating a single result or starting the Actor. Most Actors include platform usage in the price, but some may charge it separately — check the Actor's pricing for details.


tip: pls don't use long dashes - it looks AI generated

It is how english works. Just look at the rental and PPR above this one 😅

I know and I weep for em dashes too :C such a great tool is now being misused and labeled as something terrible in writing. In our own writing guidelines for AI tools we actually state that we do not want em dashes in the content, but it's not a rule in Apify Style guide, let me ping @davidjohnbarton regarding this

I spoke with Dave. I concur with @stetizu1 em dashes are not evil by themselves and if they are correctly used, we should not actively prohibit their use so I think we can leave em dashes as they are. That goes for all occurences

VojtaKai · 2026-02-10T14:02:39Z

sources/platform/actors/running/store.md

-#### Some Actors declare that I still need to pay for usage, how come?
+#### Do I need to pay for platform usage with pay per event Actors?
+
+In most cases, no — the majority of pay per event Actors include platform usage in the event price, so you only pay for the events. However, some Actors may charge platform usage separately, in addition to the event costs. Always check the pricing section on the Actor's page—it clearly states whether platform usage is included or not.


tip: we need to ban dashes

I tend to not agree here 😅 I use dashes a lot in my writing. Yes - mostly the incorrect ones 😅 But in my bachelor/diploma thesis I also replaced them with the correct ones (well, in Tex it is easy, you just do --). I don't think we should remove this concept just because AI is doing it too. And is grammatically correct.

TC-MO

Thanks for this PR 🙇

I think we have few other places where we talk about various models etc.

Namely in Academy section we have page How Actor monetization works where we describe each model and have a comparison table. It might be worth to adjust it there as well.

TC-MO · 2026-02-10T23:20:36Z

sources/platform/actors/running/store.md

@@ -25,18 +25,16 @@ All Actors in [Apify Store](https://apify.com/store) fall into one of the four p

 1. [**Rental**](#rental-actors) - to continue using the Actor after the trial period, you must rent the Actor from the developer and pay a flat monthly fee in addition to the costs associated with the platform usage that the Actor generates.
 2. [**Pay per result**](#pay-per-result) - you do not pay for platform usage the Actor generates and instead just pay for the results it produces.
-3. [**Pay per event**](#pay-per-event) - you can run the Actor and you do not pay for platform usage the Actor generates. Instead you pay for the specific events the Actor creator defines, such as for generating a single result or starting the Actor.
+3. [**Pay per event**](#pay-per-event) - you pay for specific events the Actor creator defines, such as generating a single result or starting the Actor. Most Actors include platform usage in the price, but some may charge it separately — check the Actor's pricing for details.


I know and I weep for em dashes too :C such a great tool is now being misused and labeled as something terrible in writing. In our own writing guidelines for AI tools we actually state that we do not want em dashes in the content, but it's not a rule in Apify Style guide, let me ping @davidjohnbarton regarding this

TC-MO · 2026-02-10T23:26:52Z

sources/platform/actors/running/store.md

-#### Some Actors declare that I still need to pay for usage, how come?
+#### Do I need to pay for platform usage with pay per event Actors?
+
+In most cases, no — the majority of pay per event Actors include platform usage in the event price, so you only pay for the events. However, some Actors may charge platform usage separately, in addition to the event costs. Always check the pricing section on the Actor's page—it clearly states whether platform usage is included or not.


TC-MO · 2026-02-10T23:27:43Z

sources/platform/actors/running/store.md


-When an Actor operates in [Standby mode](https://docs.apify.com/platform/actors/running/standby), you control how the background runs scale and how efficiently they are utilized. In this case, you are responsible for paying the platform usage costs of these runs in addition to the event charges. Some selected Standby Actors may have this usage component waived, so always check the pricing page of the specific Actor to determine whether you will be charged for usage or only for events.
+![Pay per event with usage not included in Apify Store](./images/store/pay_per_event_and_usage_example_actor.png)

 #### Where do I see how much I was charged for the pay per result Actors?


This I think is unrelated to changes but heading is about PPR while answer talks about PPU.

Yes, we will be deleting PPR soon anyway, so I fixed the title & removed the Similarly to pay per result Actors

TC-MO · 2026-02-10T23:36:42Z

Note: in followup we should

* remove PPR

* Maybe? move PPE to first place? I know we will still have slightly more rentals, even after PPR->E migration, but this should be our future main pricing model, we should probably "sell" it first

I could have sworn we already did that... (the reordering) but yeah definitely we should as a follow up

stetizu1 · 2026-02-11T08:53:07Z

Namely in Academy section we have page How Actor monetization works where we describe each model and have a comparison table. It might be worth to adjust it there as well.

Since this is only user-facing changes I passed this to Vojta to add to his creator-facing changes

apify-service-account · 2026-02-11T09:00:13Z

Preview for this PR was built for commit 9c519851 and is ready at https://pr-2229.preview.docs.apify.com!

mhamas · 2026-02-11T10:12:17Z

sources/platform/actors/running/store.md

+#### Do I need to pay for platform usage with pay per event Actors?
+
+In most cases, no — the majority of pay per event Actors include platform usage in the event price, so you only pay for the events. However, some Actors may charge platform usage separately, in addition to the event costs. Always check the pricing section on the Actor's page—it clearly states whether platform usage is included or not.


Suggestion: link to what platform usage actually is.

apify-service-account · 2026-02-11T10:31:22Z

Preview for this PR was built for commit 3bf9fe97 and is ready at https://pr-2229.preview.docs.apify.com!

swap screenshots for current state

2bf7b28

stetizu1 requested a review from TC-MO as a code owner February 5, 2026 17:20

stetizu1 requested review from TC-MO, Copilot and mhamas and removed request for TC-MO February 5, 2026 17:20

github-actions bot assigned stetizu1 Feb 5, 2026

github-actions bot added this to the 133rd sprint - Cash & Community team milestone Feb 5, 2026

github-actions bot added the t-c&c Team covering store and finance matters. label Feb 5, 2026

Copilot started reviewing on behalf of stetizu1 February 5, 2026 17:21 View session

Copilot AI reviewed Feb 5, 2026

View reviewed changes

sources/platform/actors/running/store.md Show resolved Hide resolved

stetizu1 changed the title ~~swap screenshots for current state~~ feat(docs): Pay-per-event with usage not included disclaimer Feb 6, 2026

one more example screenshot

582a288

stetizu1 added 2 commits February 6, 2026 11:09

replace outdated store discounts screenshots

2dd61c2

remove unused old png

8466174

remove more unused old pngs

4eeac64

stetizu1 commented Feb 6, 2026

View reviewed changes

sources/platform/actors/running/images/store/free_vs_paid_actors.png Outdated

Copy link

Contributor Author

stetizu1 Feb 6, 2026 •

edited

Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed

unused

stetizu1 commented Feb 6, 2026

View reviewed changes

sources/platform/actors/running/images/store/paid-actors-store.png Outdated

Copy link

Contributor Author

stetizu1 Feb 6, 2026 •

edited

Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed

unused

stetizu1 commented Feb 6, 2026

View reviewed changes

sources/platform/actors/running/images/store/paid-actors-trial.png Outdated

Copy link

Contributor Author

stetizu1 Feb 6, 2026 •

edited

Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed

unused

stetizu1 commented Feb 6, 2026

View reviewed changes

stetizu1 requested a review from Copilot February 6, 2026 10:25

Copilot started reviewing on behalf of stetizu1 February 6, 2026 10:25 View session

Copilot AI reviewed Feb 6, 2026

View reviewed changes

stetizu1 requested review from VojtaKai and marcel-rbro February 9, 2026 10:48

VojtaKai approved these changes Feb 10, 2026

View reviewed changes

TC-MO reviewed Feb 10, 2026

View reviewed changes

fix title

9c51985

TC-MO approved these changes Feb 11, 2026

View reviewed changes

mhamas approved these changes Feb 11, 2026

View reviewed changes

add link

3bf9fe9

stetizu1 merged commit ea5d9a4 into master Feb 11, 2026
15 checks passed

stetizu1 deleted the user-pricing-page branch February 11, 2026 10:35

		#### Do I need to pay for platform usage with pay per event Actors?

		In most cases, no — the majority of pay per event Actors include platform usage in the event price, so you only pay for the events. However, some Actors may charge platform usage separately, in addition to the event costs. Always check the pricing section on the Actor's page—it clearly states whether platform usage is included or not.

Conversation

stetizu1 commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

apify-service-account commented Feb 5, 2026

Uh oh!

stetizu1 commented Feb 6, 2026

Uh oh!

apify-service-account commented Feb 6, 2026

Uh oh!

apify-service-account commented Feb 6, 2026

Uh oh!

apify-service-account commented Feb 6, 2026

Uh oh!

stetizu1 Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Feb 6, 2026

Uh oh!

stetizu1 Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

stetizu1 Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

stetizu1 Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

stetizu1 Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

VojtaKai left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TC-MO commented Feb 10, 2026

Uh oh!

stetizu1 commented Feb 11, 2026

Uh oh!

stetizu1 commented Feb 5, 2026 •

edited

Loading

stetizu1 Feb 6, 2026 •

edited

Loading

stetizu1 Feb 6, 2026 •

edited

Loading

stetizu1 Feb 6, 2026 •

edited

Loading

stetizu1 Feb 6, 2026 •

edited

Loading

stetizu1 Feb 6, 2026 •

edited

Loading