Publit.Si
Docs›Backlog

Using Publit.Si

Backlog and content folders

Every project has a content folder on your computer. One folder inside it is one post. Publit.Si imports finished folders on its own and tracks where each post is planned or online.

The three folders

Content lives in content/<project>/ in the publitsi folder. Each project gets a fixed folder name. Accounts → the project's ⋯ → Open in Finder opens it (Explorer or your file manager on Windows and Linux). Copy inbox path copies the path of eingang/.

The names eingang, backlog and online stay the same in every language.

FolderWhat goes there
eingang/The inbox. Put finished folders here, from render scripts, your agent or other tools.
backlog/Posts that are not planned or published on every platform yet. Publit.Si moves folders here; don't write here yourself.
online/Posts that are planned or published on every platform. Publit.Si moves them here.
content/
  my-brand/
    eingang/
    backlog/
      2026-11-02-launch/
        video.mp4
        preview.png
        post.md
        alt_text.txt
        publication.json
    online/

One folder = one post

FileMeaning
Media (jpg, png, webp, mp4, mov)Ordered by file name. Several images make a carousel.
post.md or caption.txtThe post text (caption, hashtags). Optional.
alt_text.txtAlt text for the images. Optional.
publication.jsonWritten by Publit.Si: the state of the post on each platform.

How folders get imported

The worker moves a folder from eingang/ to backlog/ after one minute without changes. While a folder still contains .rendering, .part or .tmp files, it waits. Existing folders are never overwritten.

After an hour without media, the folder gets a _fehler.txt file and you get a notification. Fix the folder and delete _fehler.txt to try again.

Platform states and publication.json

publication.json records the state and link of the post on each platform. Publit.Si writes its own posts there. Entries from other tools (Buffer, Metricool …) are read too, and unrelated entries are kept.

Once every platform has a planned or published post, the folder moves to online/. Drafts never use the same folder twice on the same platform.

StateShown asMeaning
openNot plannedStill missing on this platform.
draftDraftA draft exists in Publit.Si.
scheduledScheduledPlanned for a time.
publishedOnlinePublished.
failedFailedPublishing failed. The editor shows the problem with a retry action.

The Backlog page

Backlog in the sidebar shows every folder of the project with a preview, its series and a badge per platform. The tabs Social and Blog switch between posts and blog posts (see Blog).

Filter by Status (All, Not planned, Draft, Scheduled, Online, Idea, Failed), Platform or Series, search, and switch between Grid and List. A click on a post opens its text, alt text and platforms.

Skipped on a platform means you deleted the post there on purpose (Queue › Delete) while the folder had to stay. Slot autofill and your AI leave it alone; Suggest again in the post's panel undoes that.

Each card shows the post's own title, from post.md or the renderer's manifest, instead of the folder name. One line says what is left: “Missing: TikTok”, “Failed: Instagram” or “On every platform”. The status chip only shows under All; with a status filter, the time moves under the title. Blog cards look the same.

ButtonWhat it does
PlanOpens the editor with the folder's media and text.
Plan in the StudioIn the card's ⋯ menu. Your agent writes the texts and creates a draft on the next free posting slot.
Make a ShortFor an idea that isn't filmed yet: your agent makes the video in the Studio.
DeleteIn the card's ⋯ menu. Moves the folder to the Trash, with Undo. Published posts stay as the record.

Several posts at once

  1. Tick the posts on their cards or rows. Shift-click a second post to tick every post in between. Select all shown ticks every post the filter shows.

  2. A bar at the bottom says how many are selected and offers what to do with them.

ButtonWhat it does
Plan into free slotsPuts the posts on the next free posting slots, as drafts with times. Check and schedule them under Queue › Drafts; Open drafts in the message takes you there. Posts without a free slot in the next 12 months stay drafts without a time.
DeleteAsks once, then moves the folders to the Trash, with Undo. Their drafts and queued posts are deleted for good.
Older installations

Moving an older backlog

Older installations kept backlog folders outside content/. Preview the move first, then apply it. Posts keep their folders.

pnpm content:migrate          # preview
pnpm content:migrate --apply  # move

Check

A folder you put into eingang/ shows up under Backlog with the state Not planned about a minute later.

Stuck? Search the troubleshooting list or write to us . Leave out secrets and tokens.