docs: update publish task naming and add unpublish section by jgagne · Pull Request #2855 · apify/apify-docs

jgagne · 2026-08-05T17:16:17Z

Changes

New feature documentation

Use case field (required, for Store categorization)
AI icon for generating SEO title and description
Publishing tab progress guide
Publish confirmation (privacy reassurance)
After publishing: share dialog and View landing page button
Privacy note in "After a user tries your task"
Prerequisites: blocking state when schemas are missing

SEO

Meta description rewritten: removes jargon, states outcome plainly
Weak/strong task title table: trimmed from 5 rows to 3, three examples are enough to make the point. Replaced with real example task titles from Google Maps Scraper, now names a specific city for stronger location targeting

Naming (from original PR)

"Publication" tab to "Publishing"
"Display information" to "Page details"
"SERP preview" to "Google preview"
"Examples" tab to "Example tasks"

Screenshots to update

Screenshot	Status	Notes
`task-publishing-tab.webp`	Verify	Recaptured from renamed file, confirm UI matches
`task-page-details.webp`	Verify	Recaptured from renamed file, confirm UI shows "Page details"
`task-unpublish-dialog.webp`	Missing	Needs capture (Unpublish section is new)
`actor-examples-tab.webp`	Verify	Tab was renamed to "Example tasks"
`task-input-section.webp`	OK	No UI changes
`task-dataset-schema.webp`	OK	No UI changes
`task-landing-page.webp`	OK	No UI changes

Copy lint pass

Parallel user-centered intro: "what it does, what inputs to provide, and what output to expect"
"more discoverability means more paid runs" (docs voice, replaces marketing tone)
Plain language: "shows up in Google results" (replaces "indexed by search engines")
Slug: spells out constraints (lowercase, hyphens, no spaces)
"preview updates as you type" (replaces "live preview how fields propagate")
Consistent possessive ("your original task")
Remove redundant "automatically" and "public" where context implies them
Bold all UI element names in prose (Publishing tab, Input section, Dataset schema section)

apify-service-account · 2026-08-05T17:16:57Z

🗑️ Preview for this PR was deleted.

- Fixes the SEO title field label mismatch with its own required-field error. - Renames the Publication tab to Publishing. - Renames the Display information section to Page details. - Renames SERP preview to Google preview. - Fixes Page preview and Google preview from Title Case to sentence case. - Renames the Examples tab to Example tasks. - Removes redundant phrasing across the page. - Adds a section on unpublishing a task. - Placeholder: unpublish screenshot pending capture. - Placeholder: Publish status filter pending shipping.

Copy fixes: - "what it does, what inputs to provide, and what output to expect" (parallel and user-centered, replaces "it produces") - "more discoverability means more paid runs" (docs voice, not marketing) - Slug: spell out constraints (lowercase, hyphens, no spaces) - "preview updates as you type" (replaces "live preview how fields propagate") - "your original task" (consistent possessive) - Remove "automatically" from AI generation line (redundant with AI icon) - Unpublish: state outcome of confirm action New feature documentation: - Use case field (required, for Store categorization) - AI icon for generating SEO title and description - Publishing tab progress guide - Publish confirmation (privacy reassurance) - After publishing: share dialog and View landing page button - Privacy note in "After a user tries your task" - Prerequisites: blocking state when schemas are missing

- Remove "public use-case" (redundant, not a search term) - Remove implementation detail ("by completing the... sections") - Add benefit: discoverable on Google and by AI agents - Plain language pass on AI discovery section

- "task-publication-tab" to "task-publishing-tab" (matches renamed UI) - "task-display-information" to "task-page-details" (matches renamed section) - Alt text now describes what the screenshot shows, not just labels it

- Replaces two rows with real example task titles currently live on Google Maps Scraper, verified on apify.com. - Keeps the "Generic task/Specific task" table headers as-is. - Tightens the Amazon and Yahoo Finance strong titles to a single focus each, matching the section's own stated principle. - Fixes the intro line to name all three Actors shown in the table. - Updates a leftover "dentist" reference and the URL structure example to match the new table.

- Changes "Analyze local business competitors with AI" to "Analyze San Francisco business competitors with AI", naming an actual location instead of the placeholder word "local". - Updates the matching sentence below the table to reference the new phrase. - Simplifies the sentence after the table to "Each task focuses on a specific industry, location, or workflow", removing a redundant modifier on "task". - Note: the San Francisco example is no longer verbatim from the live Google Maps Scraper Examples tab, it's a modified version. The other two rows in this table remain our own examples, not live ones.

hanatsai

Left few ideas. Thanks a lot! I'll update the image once we have updated copy in the console.

hanatsai · 2026-08-10T13:53:02Z

 ## Task landing page

-Each published task gets its own standalone landing page on the [Apify website](https://apify.com). This page is publicly accessible, indexed by search engines, and readable by AI agents. Published tasks also appear in the **Examples** tab of the Actor's detail page, linking visitors directly to the landing page.
+Each published task gets its own standalone landing page on the [Apify website](https://apify.com). Published tasks also appear in the **Example tasks** tab of the Actor's detail page, linking users directly to the landing page.


This page is publicly accessible, indexed by search engines, and readable by AI agents.

This sentence might be important for the publishers, shall we keep it?

linking users directly to the landing page.

I would keep "visitors" since they're still not becoming our user?

Restored with a rewrite.

Good instinct, but I checked, "visitors" doesn't appear anywhere in the platform docs (zero hits across /platform/). The convention is "users" for everyone, including people who haven't signed up. Kept it for consistency with the rest of the docs.

- Public tasks to Published tasks (consistent with rest of page) - Indexed sentence was moved to Target search traffic section, not removed

…s into docs/publish-task-update

jbartadev

Nice job! Added a couple of suggestions and nits

jbartadev · 2026-08-11T06:31:20Z

+
+Unpublishing removes the landing page, but your task and its configuration stay saved. Republish anytime.
+
+![Unpublish confirmation dialog with a Confirm button.](./images/public-tasks/task-unpublish-dialog.webp)


Important: task-unpublish-dialog.webp is missing. It isn't in the branch with other changes -images/public-tasks/ only has actor-examples-tab, task-dataset-schema, task-input-section, task-landing-page, task-page-details, task-publishing-tab.

@hanatsai is handling screenshots. With a noted contribution update from Docs on screenshots:

apify-docs/CONTRIBUTING.md

Line 121 in dfd6ea4

3. Screenshots:

- Meta description: "Google" to "search engines" (broader, 140 chars) - "After publishing" to "Publish confirmation" (dialog appears before, not after) - Clarify dialog timing: "When you select Publish task, a confirmation..." - AI icon: add "next to each field" for discoverability

hanatsai

Thanks Justin! Let's merge it. I'll adjust the screenshot later 🙏 (if we have text placeholder for the image, let's make sure we remove it before the merge)

task-unpublish-dialog.webp does not exist yet. Replaced broken image reference with HTML comment to prevent broken image in production.

TC-MO · 2026-08-18T12:54:15Z

Can I get a bit of context on that? Those are some pretty significant documentation changes yet not TW was pulled for any review or consulted at all?

hanatsai · 2026-08-18T12:59:54Z

Hi Michal @TC-MO sorry for not align with you about the changes. It's related to this feedback and we did a copy updates for the published tasks. It'll soon released with this PR. It's also nice to synchronize the copy in the publish task documentation. That's why we did the copy review and update with Justin here.

TC-MO · 2026-08-18T13:10:48Z

Hey @hanatsai thanks for the context. It's all good we encourage teams pitching in to docs :) But important for us is that @apify/docs team is always pulled as reviewer for changes to make sure that changes are inline with our style guide etc. So in the future please either use @apify/docs or just pull your groups assigned TW as reviewer. @marcel-rbro can you take a look here make sure everything is fine?

TC-MO · 2026-08-18T13:14:38Z

Oh and please also any changes to documentation should be labeled with documentation label. This way it will also show up on our docs kanban instead of getting lost

jgagne · 2026-08-18T15:59:24Z

@TC-MO My apologies for not following up sooner. Thank you for your feedback.

jgagne changed the title ~~docs: fix publish task naming and add unpublish section~~ docs: update publish task naming and add unpublish section Aug 5, 2026

jgagne self-assigned this Aug 5, 2026

jgagne force-pushed the docs/publish-task-update branch 2 times, most recently from 55b393b to 0ce96c8 Compare August 5, 2026 21:05

jgagne added 2 commits August 5, 2026 23:08

docs: improve meta description for SEO

2f0165c

- Remove "public use-case" (redundant, not a search term) - Remove implementation detail ("by completing the... sections") - Add benefit: discoverable on Google and by AI agents - Plain language pass on AI discovery section

jgagne force-pushed the docs/publish-task-update branch from 0ce96c8 to 2f0165c Compare August 5, 2026 21:09

docs: bold Publishing tab references for consistency

bf5e6d3

jgagne force-pushed the docs/publish-task-update branch from 540686a to bf5e6d3 Compare August 5, 2026 21:13

docs: rename screenshot files and improve alt text

540e821

- "task-publication-tab" to "task-publishing-tab" (matches renamed UI) - "task-display-information" to "task-page-details" (matches renamed section) - Alt text now describes what the screenshot shows, not just labels it

jgagne force-pushed the docs/publish-task-update branch from 741d4ce to 540e821 Compare August 5, 2026 21:22

jgagne added the adhoc Ad-hoc unplanned task added during the sprint. label Aug 6, 2026

jgagne added 4 commits August 6, 2026 15:22

Merge branch 'master' into docs/publish-task-update

9f6148a

Merge commit '9f6148a3' into temp-rebuild

4e255ba

jgagne force-pushed the docs/publish-task-update branch from d0ba748 to 8885897 Compare August 6, 2026 14:21

jgagne marked this pull request as ready for review August 10, 2026 12:15

jgagne requested review from hanatsai and martin-sabo-98 August 10, 2026 12:15

hanatsai requested review from jbartadev and removed request for martin-sabo-98 August 10, 2026 12:59

hanatsai reviewed Aug 10, 2026

View reviewed changes

jgagne added 2 commits August 10, 2026 18:48

docs: address reviewer feedback

3d15eac

- Public tasks to Published tasks (consistent with rest of page) - Indexed sentence was moved to Target search traffic section, not removed

Merge branch 'docs/publish-task-update' of github.com:apify/apify-doc…

2bc49a5

…s into docs/publish-task-update

jgagne force-pushed the docs/publish-task-update branch from a3397e6 to 2bc49a5 Compare August 10, 2026 17:21

jgagne requested a review from hanatsai August 10, 2026 17:24

jbartadev reviewed Aug 11, 2026

View reviewed changes

jgagne force-pushed the docs/publish-task-update branch from 15eaf62 to 8d056dd Compare August 11, 2026 14:37

jgagne requested a review from jbartadev August 11, 2026 14:38

jbartadev approved these changes Aug 11, 2026

View reviewed changes

hanatsai approved these changes Aug 18, 2026

View reviewed changes

docs: replace missing screenshot with TODO comment

2e3793d

task-unpublish-dialog.webp does not exist yet. Replaced broken image reference with HTML comment to prevent broken image in production.

jgagne merged commit c26acd2 into master Aug 18, 2026
14 checks passed

jgagne deleted the docs/publish-task-update branch August 18, 2026 12:11

jgagne added the documentation Improvements or additions to documentation. label Aug 18, 2026


		Unpublishing removes the landing page, but your task and its configuration stay saved. Republish anytime.

		![Unpublish confirmation dialog with a Confirm button.](./images/public-tasks/task-unpublish-dialog.webp)

Uh oh!

Conversation

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

Uh oh!

Changes

New feature documentation

SEO

Naming (from original PR)

Screenshots to update

Copy lint pass

Uh oh!

apify-service-account commented Aug 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

hanatsai left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

hanatsai Aug 10, 2026

Choose a reason for hiding this comment

Uh oh!

hanatsai Aug 10, 2026

Choose a reason for hiding this comment

Uh oh!

jgagne Aug 10, 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!

jbartadev left a comment

Choose a reason for hiding this comment

Uh oh!

jbartadev Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

jgagne Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

hanatsai left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

TC-MO commented Aug 18, 2026

Uh oh!

hanatsai commented Aug 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

TC-MO commented Aug 18, 2026

Uh oh!

TC-MO commented Aug 18, 2026

Uh oh!

jgagne commented Aug 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

jgagne commented Aug 5, 2026 •

edited

Loading

apify-service-account commented Aug 5, 2026 •

edited

Loading

jgagne Aug 10, 2026 •

edited

Loading

hanatsai commented Aug 18, 2026 •

edited

Loading