feat(docs): Multiple datasets by valekjo · Pull Request #2228 · apify/apify-docs

valekjo · 2026-02-05T14:34:44Z

The feature is now supported in both SDKs and API docs is out - we can finally publish the respective section in docs :)

apify-service-account · 2026-02-05T14:37:32Z

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

apify-service-account · 2026-02-05T14:41:06Z

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

apify-service-account · 2026-02-09T09:40:24Z

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

apify-service-account · 2026-02-12T10:42:53Z

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

apify-service-account · 2026-02-24T11:03:56Z

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

apify-service-account · 2026-03-03T09:53:31Z

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

apify-service-account · 2026-03-03T10:29:37Z

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

apify-service-account · 2026-03-05T09:01:55Z

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

apify-service-account · 2026-03-06T22:00:32Z

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

apify-service-account · 2026-03-07T00:06:19Z

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

apify-service-account · 2026-03-11T16:16:53Z

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

apify-service-account · 2026-03-12T14:21:41Z

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

TC-MO · 2026-03-12T19:04:45Z

@valekjo no worries! A lot of those can be now caught using our review skill for Claude-code (we might enhance them to be agent agnostic, but for now it's Claude-centric)

TC-MO · 2026-03-12T19:05:06Z

I'll make another pass that focus more on the doc itself later today instead of low-hanging fruits

- Update the documentation to clarify the use of multiple datasets in Actors, including definitions, requirements, and access methods - Update explanations of aliases versus named datasets and billing implications

jgagne

This looks great. Consider the edits in the commit(s) from this review.

janbuchar · 2026-03-13T15:55:18Z

sources/platform/actors/development/actor_definition/dataset_schema/multiple_datasets.md

+**Requirements:**
+
+- The `datasets` object must contain the `default` alias
+- The `datasets` and `dataset` objects are mutually exclusive (use one or the other)


It'd be great to link the actor.json reference from here so that the reader can understand the difference between dataset and datasets better.

Do you mean the reference from docs or the publicly available schema files?

The reference in the docs

sources/platform/actors/development/actor_definition/dataset_schema/multiple_datasets.md

janbuchar · 2026-03-13T15:57:29Z

sources/platform/actors/development/actor_definition/dataset_schema/multiple_datasets.md

+
+### Environment variable
+
+Access the environment variable directly without the SDK:


Maybe elaborate a bit what this will do (give you a dataset ID)

janbuchar · 2026-03-13T15:58:41Z

sources/platform/actors/development/actor_definition/dataset_schema/multiple_datasets.md

+        "products": {
+            "type": "string",
+            "title": "Products",
+            "template": "{{storages.datasets.default.apiUrl}}/items"
+        },
+        "categories": {
+            "type": "string",
+            "title": "Categories",
+            "template": "{{storages.datasets.categories.apiUrl}}/items"
+        }


So... what does this (mainly the template field) actually do?

That should be clear from the output schema docs. Basically, this will show a dropdown (or tabs) in the Actor run Output tab, with "Products" and "Categories", and if the datasets also have some views defined, the users can switch between those too.

Bold of you to assume that the reader saw and understood that 🙂 Maybe you could add a link to the "How templates work" section?

TC-MO

Second pass done focusing more on the document itself instead of low-hanging fruits.

sources/platform/actors/development/actor_definition/dataset_schema/multiple_datasets.md

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

apify-service-account · 2026-03-18T11:24:18Z

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

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

apify-service-account · 2026-03-18T11:27:51Z

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

apify-service-account · 2026-03-18T11:31:45Z

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

feat(docs): Multiple datasets

93a1efe

github-actions bot assigned valekjo Feb 5, 2026

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

github-actions bot added the t-console Issues with this label are in the ownership of the console team. label Feb 5, 2026

Added todos

29d954f

Update variable name

9bd61b8

Address changes

dbf37ac

Comments

da0b5f0

Mention UI

97effac

valekjo force-pushed the feature/multiple-datasets branch from 652317c to 97effac Compare March 5, 2026 08:58

danpoletaev force-pushed the feature/multiple-datasets branch from 97effac to bf23549 Compare March 6, 2026 21:56

metalwarrior665 force-pushed the feature/multiple-datasets branch from bf23549 to 97effac Compare March 7, 2026 00:02

Progress

c0dd0c4

valekjo added 5 commits March 11, 2026 17:18

Progress

de69ce7

Progress

6f690e7

Fix lint error

4c48fdf

Merge branch 'master' into feature/multiple-datasets

9af53b2

missing .

0a79a25

valekjo requested a review from janbuchar March 12, 2026 08:49

valekjo requested a review from TC-MO March 12, 2026 14:20

Update multiple datasets documentation

fdbcb23

- Update the documentation to clarify the use of multiple datasets in Actors, including definitions, requirements, and access methods - Update explanations of aliases versus named datasets and billing implications

jgagne requested changes Mar 13, 2026

View reviewed changes

jgagne and others added 2 commits March 13, 2026 12:41

Fix formatting of info and warning blocks in markdown

be76aa7

MD blocks end marks

3bb3fa9

valekjo requested a review from jgagne March 13, 2026 15:37

fix: trailing newline

64f7dcb

jgagne approved these changes Mar 13, 2026

View reviewed changes

janbuchar requested changes Mar 13, 2026

View reviewed changes

TC-MO requested changes Mar 13, 2026

View reviewed changes

valekjo and others added 9 commits March 18, 2026 12:14

Update sources/platform/actors/development/actor_definition/dataset_s…

d6064df

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/development/actor_definition/dataset_s…

3606805

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/development/actor_definition/dataset_s…

e8bf944

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/development/actor_definition/dataset_s…

a43ca79

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/development/actor_definition/dataset_s…

9052aef

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/development/actor_definition/dataset_s…

e7628bc

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Fix link

cb2a3be

Update sources/platform/actors/development/actor_definition/dataset_s…

64be8f1

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/development/actor_definition/dataset_s…

9a1c122

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

valekjo and others added 3 commits March 18, 2026 12:24

fix link

aa4dae6

Update sources/platform/actors/development/actor_definition/dataset_s…

31b586f

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/development/actor_definition/dataset_s…

d6381bc

…chema/multiple_datasets.md Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

valekjo requested review from TC-MO and janbuchar March 18, 2026 11:55


		### Environment variable

		Access the environment variable directly without the SDK:

Conversation

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

Uh oh!

Uh oh!

apify-service-account commented Feb 5, 2026

Uh oh!

apify-service-account commented Feb 5, 2026

Uh oh!

apify-service-account commented Feb 9, 2026

Uh oh!

apify-service-account commented Feb 12, 2026

Uh oh!

apify-service-account commented Feb 24, 2026

Uh oh!

apify-service-account commented Mar 3, 2026

Uh oh!

apify-service-account commented Mar 3, 2026

Uh oh!

apify-service-account commented Mar 5, 2026

Uh oh!

apify-service-account commented Mar 6, 2026

Uh oh!

apify-service-account commented Mar 7, 2026

Uh oh!

apify-service-account commented Mar 11, 2026

Uh oh!

apify-service-account commented Mar 12, 2026

Uh oh!

TC-MO commented Mar 12, 2026

Uh oh!

TC-MO commented Mar 12, 2026

Uh oh!

jgagne left a comment • 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!

janbuchar Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

valekjo Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

janbuchar Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

janbuchar Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

janbuchar Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

valekjo Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

janbuchar Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Mar 18, 2026

Uh oh!

apify-service-account commented Mar 18, 2026

Uh oh!

apify-service-account commented Mar 18, 2026

Uh oh!

Reviewers

Assignees

Labels

valekjo commented Feb 5, 2026 •

edited

Loading

jgagne left a comment •

edited

Loading