How to Edit a Blog Post

Editing lets you update, improve, and refine your blog posts. This guide covers making changes, using AI assistance, and managing post revisions.

Prerequisites

Before you begin:

• You must be signed in to your account
• You must be the post author or a team owner
• The post must exist (draft, published, or archived)

Editing a Post

Step 1: Navigate to Blog

From the sidebar, click Blog to view your posts.

Step 2: Open the Post

Click on the post card or the edit button to open the editor.

Step 3: Make Changes

Edit any of the available fields:

Step 4: Save Changes

Click Save to apply your changes. The post version increments for content changes.

Editing Published Posts

You can edit published posts directly:

• Changes are saved immediately
• The public URL remains the same
• Previous versions are not preserved
• Version number increments for content changes

Consider unpublishing first if making significant changes.

AI-Powered Improvements

Use AI to enhance your draft content:

Step 1: Open the AI Improvement Panel

In the post editor, locate the AI improvement section.

Step 2: Select Focuses

Choose one or more improvement areas:

Step 3: Add Custom Instructions (Optional)

Provide specific guidance:

Make the introduction more engaging.
Add a conclusion section.
Use more technical terminology.
Simplify for beginners.

Step 4: Run Improvement

Click the improve button. The AI processes your content and returns an enhanced version.

Step 5: Review and Accept

• Review the improved content
• Accept to replace your current body
• Or discard to keep your original

AI Rate Limits

AI improvements are limited to:

• 5 requests per hour per user

This helps manage API usage across the team.

Version Management

Posts track version numbers:

• Version 1: Initial creation
• Version increments on: title, body, or excerpt changes
• Version unchanged for: tag or setting changes only

Version history is not exposed in the UI but tracked in the database.

Changing Post Type

Switch between post types:

When switching to Workflow Write-up:

1. Select a linked workflow
2. Add prerequisites information
3. Add compatibility notes

Updating Tags

To modify tags:

1. Open the post editor
2. Locate the Tags section
3. Click to open the tag selector
4. Add or remove tags
5. Save the post

Tag changes update immediately and affect filtering.

Updating Project Association

To change or remove the project link:

1. Open the post editor
2. Find the Project dropdown
3. Select a different project or "None"
4. Save the post

Troubleshooting

"You do not have permission to edit this post" error

Only the post author or team owners can edit. Contact your team owner.

Slug changed after editing title

Slugs regenerate when titles change to maintain URL consistency. The public slug (if published) remains unchanged.

AI improvement not working

• Check that your content has a body
• Verify rate limit hasn't been exceeded
• Ensure OPENAI_API_KEY is configured (contact your admin)

Changes not saving

• Check for validation errors (title required, content required)
• Verify you have a stable connection
• Try refreshing and making changes again

Best Practices

1. Save frequently - Don't lose work during long editing sessions
2. Review AI changes - Always verify AI-generated improvements
3. Update SEO fields - Keep meta information current with content changes
4. Check formatting - Preview Markdown rendering after edits
5. Version major updates - Consider creating new posts for major rewrites

Editing vs Creating New

Next Steps

After editing:

• Publish your changes if the post is a draft
• Manage comments on the updated post
• Share updated content if significant changes

Related

• Blog overview - Learn about the blog system
• How to create a post - Create new content
• How to publish a post - Make posts public