Overview
Blogs are the top-level organizational unit in Postnomic. Each blog has its own content, users, settings, and API keys. Depending on your subscription plan, you can create multiple blogs under a single account.
Creating a New Blog
To create a blog, navigate to the dashboard and click Create Blog. Fill in the following fields:
Required Fields
- Name — The display name for your blog (e.g., "Tech Insights Blog"). This appears in listings and page titles.
- Slug — A URL-friendly identifier used in API calls and routing (e.g.,
tech-insights). The slug must be unique across the platform and contain only lowercase letters, numbers, and hyphens. It can be changed later in the blog settings, but any Client SDK configuration and external link pointing at the old slug will break, so choose carefully.
Optional Fields
- Description — A short summary of your blog's topic and purpose. Displayed in blog listings and metadata.
- Canonical URL — The primary URL where your blog is hosted (e.g.,
https://example.com/blog). Used for SEO and cross-posting canonical link resolution.
Blog Ownership
When you create a blog, you are automatically assigned as the Owner (OwnerId) and given the Admin role via a BlogUser record. Ownership determines:
- Quota enforcement — Your subscription plan limits are enforced based on how many blogs you own.
- Storage tracking — Media storage is counted across all blogs you own via the
StorageUsedBytesproperty. - Billing responsibility — The owner's subscription plan governs what features are available on the blog.
Multi-Blog Support
The number of blogs you can create depends on your subscription plan:
| Plan | Blog Limit |
|---|---|
| Free | 1 |
| Plus | 3 |
| Pro | 10 |
| Enterprise | Unlimited |
If you attempt to create a blog that would exceed your plan's limit, the API returns a 403 Forbidden response with a message explaining the quota restriction.
Blog Identity
Each blog has two identifiers:
- Slug — The human-readable identifier used in URLs and API calls. Set at creation and changeable afterwards, though changing it breaks existing links and SDK configuration.
- PublicId — A
Guidused in API responses and references. This hides the internal database ID for security.
After Creation
Once your blog is created, you can:
- Configure settings — Set comment rules, choose a layout (Default or Masonry), and customize moderation preferences.
- Generate API keys — Create keys for your applications to access blog content through the Client SDKs.
- Invite team members — Add authors, editors, and reviewers to collaborate on content.
- Start publishing — Create your first post and begin building your content library.
Deleting a Blog
Blog deletion removes all associated content, including posts, comments, media, tags, categories, and user assignments. This action is permanent and cannot be undone. Only blog admins can delete a blog.