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, contain only lowercase letters, numbers, and hyphens, and cannot be changed after creation.
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 immutable.
- 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.