Skip to main content
Postiz has a small vocabulary that the rest of these docs, the API and the support channels all assume. This page defines it once.

​
Organisation

Everything you own lives inside an organisation: channels, posts, media, tags, team members and settings. You can belong to more than one, and when you do, an organisation switcher appears in the top bar. Switching reloads the app into that organisation’s data. The first person to register creates the organisation and becomes its owner. Others join by invitation, see Team.

​
Channel

A channel is one connected social account: one X profile, one LinkedIn page, one Discord server, one subreddit-capable Reddit account. Connecting the same platform twice gives you two channels.
The app says channel. The Public API and the CLI say integration. They are the same object. Anywhere the API asks for an integration.id, it wants the ID of a channel, which you can copy from the channel’s context menu.
Channels can be disabled rather than deleted. A disabled channel keeps its history and stops being available for posting. On cloud, disabling is how you free a slot when you hit your plan’s channel cap.

​
Customer

A customer is a group of channels, normally one client of yours. Assigning channels to a customer lets you filter the whole calendar down to that client, and select all of their channels at once in the composer. Customers also unlock an invite link: you can send a client a link that lets them connect their own account into your organisation without having an account of their own. See Client groups and invite links.

​
Post and post group

When you schedule one piece of content to five channels, Postiz stores five posts that share a group. That is why the API has both deletePost and deletePostsFromGroup, and why deleting from the calendar removes the whole set by default. Inside a single post you can have multiple parts: a thread on X, a post plus comments on LinkedIn. Part one is the post, the rest are thread items or comments depending on what the platform supports. See Threads and comments.

​
Global vs per-channel content

By default you write once in the Global tab and every selected channel gets the same text. Unlocking a channel’s own tab detaches it, so you can rewrite that version without touching the others. Mentions are only available on a detached channel, because a handle is only meaningful on one platform.

​
Settings

Each platform has its own settings: a YouTube title and privacy level, a Reddit subreddit and flair, a Pinterest board. They appear in the composer next to the preview, and in the API as a settings object with a __type naming the platform. Some are required and the post will not save without them.

​
Tag

A tag is a coloured label on a post. The colour is what the post card shows on the calendar, which makes tags the practical way to see campaign, client or content type at a glance.

​
Set

A set is a saved selection of channels and their settings. When you start a new post, Postiz offers your sets so you can load “the client A channels, configured the way I always configure them” instead of rebuilding it.

​
Signature

A signature is a block of content you append to posts. One signature can be marked auto-add, and it is then inserted into every new post automatically.

​
Time slot

Each channel has a list of time slots, the times of day it normally posts. Slots drive three things: the rows in the calendar’s Day view, the “next available slot” that RSS auto-posting uses, and the find-slot API endpoint. They are a scheduling convenience, not a restriction: you can always post at a time that is not a slot.

​
Post state

Every post has a public preview page. Sharing that link lets a client read the post as it will appear and leave comments, without an account. See Share a post for approval.

​
Plug

A plug is an automation attached to a channel that fires after a post publishes, for example auto-reposting it later or adding a follow-up comment. Plugs exist for a handful of platforms only. See Plugs.