Browser extension
Configure the Postiz browser extension on a self-hosted instance
Self-hosted only. This page describes configuration you do on your own Postiz instance. On Postiz Cloud it is already handled for you, so nothing here applies.
Platforms with no public posting API, Skool being the current one, connect through the Postiz browser extension: it reads your existing session cookies for that platform and passes them to your backend, where they are stored encrypted and refreshed every 24 hours.
Connecting a channel this way is covered in Connect a channel. This page is the instance-side configuration: the extension ID, and building the extension yourself.
Using cookies to interact with platforms may violate their terms of service. Use this feature at your own risk.
Installation
Install the Extension
Install the Postiz browser extension from the Chrome Web Store.
Alternatively, for self-hosted setups, you can build the extension from source:
cd apps/extension
pnpm buildThen load the apps/extension/dist folder as an unpacked extension in Chrome:
- Navigate to
chrome://extensions/ - Enable Developer mode (top right toggle)
- Click Load unpacked and select the
distfolder
Get the Extension ID
After installing the extension, you need its Extension ID:
- Go to
chrome://extensions/in Chrome - Find the Postiz extension
- Copy the ID shown under the extension name (e.g.,
cidhffagahknaeodkplfbcpfeielnkjl)
If you installed from the Chrome Web Store, the ID is: cidhffagahknaeodkplfbcpfeielnkjl
Configure the Environment Variable
Add the extension ID to your Postiz environment variables:
EXTENSION_ID="cidhffagahknaeodkplfbcpfeielnkjl"Restart Postiz after setting this variable.
Supported Platforms
The following platforms use the Chrome Extension for authentication:
Self-Hosted Considerations
If you are self-hosting Postiz on a domain other than localhost or *.postiz.com, you need to build a custom extension with your domain in the externally_connectable manifest field.
Edit apps/extension/manifest.json and add your domain:
{
"externally_connectable": {
"matches": [
"http://localhost/*",
"https://localhost/*",
"https://*.postiz.com/*",
"https://your-domain.com/*"
]
}
}Then rebuild the extension and load it as an unpacked extension in Chrome.
Troubleshooting
- "Extension not found": Make sure the
EXTENSION_IDenvironment variable is set and Postiz has been restarted. - "Extension not reachable": The extension may be disabled. Check
chrome://extensions/and make sure Postiz is enabled. - "Could not get cookies": You must be logged in to the platform in the same Chrome browser where the extension is installed.
- Cookies expire: The extension automatically refreshes cookies every 24 hours. If a connection drops, try reconnecting the channel.