Dashboard Guide

The Postlark Dashboard at app.postlark.ai is the web interface for managing your blog. This guide walks you through every feature.

Sign Up & Sign In

1. Go to app.postlark.ai/signup
2. Sign up with Google, GitHub, or email/password
3. After signing in, you’ll land on the Dashboard overview page

Tip

If you signed up via CLI (postlark login), your account is already created. Just sign in with the same credentials.

Dashboard Overview

The main dashboard shows:

• Quick Setup Guide — MCP installation command for Claude Code/Cursor
• Blog subdomain — Your blog’s URL (e.g., my-blog.postlark.ai)
• Quick stats — Post count and blog status

The sidebar on the left gives you access to all sections:

Section	Description
Dashboard	Overview and quick setup
Posts	Create, edit, and manage posts
Search	Full-text search across your posts
Analytics	View counts and top posts
Access Tokens	Create scoped API tokens
Settings	Blog name, domain, theme, API keys
Billing	Plan, usage, and post packs
Account	Profile, data export, account deletion

Writing Posts

Create a New Post

1. Click Posts in the sidebar
2. Click New Post (top right)
3. Fill in the details:
   • Title — Your post title (required)
   • Slug — URL path (auto-generated from title if left empty)
   • Meta Description — For SEO (auto-generated from content if left empty)
   • Tags — Type a tag and press Enter to add
4. Write your content in the left pane using Markdown
5. Preview renders in real-time in the right pane

Markdown Editor Features

The split-pane editor supports:

• Live preview — See rendered output as you type
• All Markdown extensions — Math (KaTeX), diagrams (Mermaid), code highlighting, callouts, footnotes, emoji, and more
• Image drag & drop — Drag an image into the editor to upload it. The image URL is automatically inserted as Markdown.
• Keyboard shortcuts — Standard text editing shortcuts

See Markdown Features for the full list of supported syntax.

Save, Publish, or Schedule

At the bottom of the editor, you have three options:

Button	Action
Save Draft	Save without publishing. Only you can see it.
Publish	Make the post live on your blog immediately.
Schedule	Set a future date/time for automatic publication (Creator+ plan).

To schedule a post:

1. Click Schedule
2. Pick a date and time using the date picker
3. Click Confirm Schedule

Note

Scheduled posts require the Creator plan or above. The system checks every minute and publishes posts when their scheduled time arrives.

Edit an Existing Post

1. Go to Posts
2. Click the Edit button on any post
3. Make your changes
4. Click Save Draft or Publish

Delete a Post

1. Go to Posts
2. Click the delete icon next to the post
3. Confirm the deletion

Caution

Deletion is permanent and cannot be undone.

Search

1. Click Search in the sidebar
2. Type your query — searches across titles, descriptions, headings, and tags
3. Click a result to open it in the editor

Analytics

Note

Analytics require the Starter plan or above.

Blog Overview

The Analytics page shows:

• Views (7 days) and Views (30 days) — Total page views
• Daily Views Chart — Bar chart of the last 30 days
• Top Posts — Most viewed posts ranked by view count

Per-Post Analytics

Click any post in the Top Posts list to see:

• 7-day and 30-day view counts for that specific post
• A daily breakdown chart

Blog Settings

Go to Settings to configure your blog:

Basic Info

• Blog Name — Display name shown on your blog
• Description — Brief description for SEO and discovery

Custom Domain (Creator+)

1. Enter your domain (e.g., blog.example.com)
2. Click Connect Domain
3. Add a CNAME record in your DNS settings pointing to postlark.ai
4. Wait for SSL provisioning (usually a few minutes)

See Custom Domain Guide for detailed instructions.

Custom CSS (Starter+)

Add custom CSS to style your blog. Changes apply immediately — no rebuild needed.

Custom HTML (Creator+)

Add custom header and footer HTML for advanced customization.

API Keys

Manage API keys for your blog:

1. Click Create API Key
2. Give it a name (e.g., “n8n automation”)
3. Copy the key immediately — it won’t be shown again
4. Use the key for API access or MCP server setup

Access Tokens

Go to Access Tokens to create scoped tokens (like GitHub Personal Access Tokens):

1. Click Create Token
2. Set:
   • Name — Descriptive name
   • Scopes — Select which permissions to grant (e.g., posts:read, posts:write)
   • Blog — Optionally bind to a specific blog
   • Expiration — How long the token is valid
3. Click Create
4. Copy the token immediately — it won’t be shown again

Tip

Use scoped tokens instead of full API keys when you only need limited access. This follows the principle of least privilege.

Billing

Current Plan & Usage

The Billing page shows:

• Usage bar — How many posts you’ve published this month vs. your plan limit
• Plan comparison — All plans with features and pricing
• Monthly/Annual toggle — Annual billing saves ~17%

Upgrade

Click Upgrade on any plan to open the Paddle checkout. Postlark uses Paddle as the payment processor, which handles VAT/GST automatically.

Post Packs (Starter+)

If you exceed your monthly post limit, purchase a Post Pack:

• 50 posts — $12 (never expires)
• 200 posts — $29 (never expires)

Post packs are used only when you exceed your monthly quota. Monthly quota is always consumed first.

Manage Subscription

Click Manage Subscription to access the Paddle Customer Portal where you can update payment methods or cancel.

Account Settings

Profile

View your name, email, and current plan.

Export Data (GDPR)

Click Export Data to download all your posts and blog data as a JSON file.

Delete Account

To permanently delete your account:

1. Click Delete Account
2. Type DELETE MY ACCOUNT in the confirmation field
3. Click Permanently Delete

Caution

This deletes all your blogs, posts, API keys, and account data. This action cannot be undone.

Multi-Blog Support

If your plan allows multiple blogs:

1. Use the blog selector in the sidebar to switch between blogs
2. Or click Create Blog to add a new one
3. Each blog has its own subdomain, posts, settings, and API keys

Next Steps

• CLI Guide — Manage your blog from the terminal
• MCP Server — Publish directly from Claude Code or Cursor
• SEO Guide — Understand Postlark’s automatic SEO features