Skip to content

docs(autopost): RSS auto-posting creates drafts, drop the post-timing step - #263

Merged
egelhaus merged 1 commit into
mainfrom
docs/autopost-drafts
Nov 9, 2026
Merged

egelhaus merged 1 commit into
mainfrom
docs/autopost-drafts

Conversation

@giladresisi

@giladresisi giladresisi commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

What kind of change does this PR introduce?

Documentation fix for RSS auto-posting (Settings, Auto Post). Auto Post creates every new feed item as a draft on the next available time slot and never publishes on its own, but general/automations/auto-post-rss.mdx said every item "becomes a post" and described a "Choose when it posts" step ("Post immediately" / "Post on the next available slot"). That option was removed from the app in gitroomhq/postiz-app#2283 because the backend never read it. The page now states the draft behavior in the intro and in a warning box, drops that step and the related "next available slot" tip, rewords the "sync the current last post" step, and adds a final "Review and schedule the drafts" step. Three one-line mentions are aligned: general/channels/time-slots.mdx, general/where-things-live.mdx and cloud/plans.mdx. Plan availability, content modes and everything else on those pages are unchanged.

Why

Cloud users reported on 2026-10-19 and 2026-11-07 that their feeds only produced drafts and that the option described in the docs was missing from the form.

QA

  1. Open the preview of general/automations/auto-post-rss.mdx and confirm the warning box renders under the intro and links to the time slots page.
  2. Confirm the "Setting up a feed" steps no longer include "Choose when it posts" and end with "Review and schedule the drafts".
  3. In Postiz, open Settings, Auto Post, Add Autopost, and confirm the form fields match the documented steps (no post-timing dropdown) and the description says autopost creates drafts.
  4. Open general/channels/time-slots.mdx, general/where-things-live.mdx and cloud/plans.mdx and confirm the RSS auto-posting lines mention drafts and the tables still render correctly.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated the plans page and settings guide to describe RSS auto-posting as creating drafts rather than scheduled posts.
    • Clarified that new feed items become drafts assigned to a time slot and are not published automatically. Added guidance to review and schedule drafts, including when syncing an existing feed item.
    • Updated setup and practical advice to focus on monitoring drafts, and clarified how channel time slots are used.

…-timing step

Auto Post creates every new feed item as a draft on the next available
time slot; it never publishes on its own. The page still described a
"Choose when it posts" step ("Post immediately" / "Post on the next
available slot") that the app no longer shows and the backend never read.

The RSS auto-posting page now states the draft behavior up front, drops
that step, and adds a review-and-schedule step. Three one-line mentions on
the time slots, where-things-live and plans pages are aligned.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@giladresisi
giladresisi requested a review from egelhaus as a code owner November 9, 2026 08:27
@postiz-contribution postiz-contribution Bot added the contribution:approved Approved contributor label Nov 9, 2026
@coderabbitai

coderabbitai Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

Explain Change →

Caution

Review failed

The pull request is closed.

Walkthrough

The documentation now describes RSS Auto Post as creating drafts instead of scheduled posts. It states that drafts require review and scheduling, and updates setup guidance and related page descriptions.

Changes: RSS Auto Post documentation

Layer / File(s) Summary
Draft creation and guidance
general/automations/auto-post-rss.mdx, cloud/plans.mdx, general/channels/time-slots.mdx, general/where-things-live.mdx
The guide describes new and existing feed items as drafts for review and scheduling. Related pages update their descriptions of RSS Auto Post. The guide also changes its monitoring advice to refer to drafts.

Estimated code review effort: 2 (Simple) | ~8 minutes

Change: Other

Merge Risk: Low · up to 7449f

The draft-only guidance is supported, but readers may look for drafts at the wrong time or expect an inactive feed to sync immediately. These localized clarifications can be addressed without blocking merge.

- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@egelhaus
egelhaus merged commit 496ffb2 into main Nov 9, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution:approved Approved contributor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants