Skip to main content

Content Management Guide

Complete guide for creating, managing, and publishing content on the AI Agentification Platform.

Table of Contents​

Content Creation Workflow​

1. Plan Your Content​

Before creating content:

  • Define your target audience
  • Choose content type (blog, tutorial, lesson, tip, case_study)
  • Determine difficulty level (beginner, intermediate, advanced)
  • Plan structure and key points

2. Create or Generate Content​

Option A: Manual Creation

  1. Go to /admin/content/new
  2. Fill in all required fields
  3. Write content in TipTap editor
  4. Add images and media
  5. Preview and publish

Option B: AI-Generated Content

  1. Use AI prompts (see AI_GENERATION.md)
  2. Generate complete content structure
  3. Review and customize output
  4. Import or copy to content editor
  5. Add finishing touches

3. Add Media​

Featured Images:

  • Recommended size: 1920x1080px (16:9)
  • Format: JPG or PNG
  • Max size: 500KB recommended
  • Use descriptive alt text

Inline Images:

  • Upload via Media Library
  • Copy URL and insert in editor
  • Add captions for context

Videos:

  • YouTube or Vimeo URLs supported
  • Add as featured video or embed in content
  • Include captions for accessibility

Using the Content Editor​

Required Fields​

  • Title: Compelling, SEO-friendly (max 60 chars recommended)
  • Slug: URL-friendly (auto-generated from title)
  • Content Type: blog | tutorial | lesson | tip | case_study
  • Access Level: public | registered | premium | course_specific
  • Content: Main body (TipTap rich text)
  • Subtitle: Catchy one-liner
  • Excerpt: 150-200 character preview
  • Category: Organize content
  • Tags: 5-7 relevant keywords
  • Difficulty Level: beginner | intermediate | advanced
  • Featured Image: Main visual
  • Meta Title: SEO title (60 chars)
  • Meta Description: SEO description (160 chars)

TipTap Editor Features​

  • Rich Text Formatting: Bold, italic, strikethrough, code
  • Headings: H1-H6 (use H2-H3 for sections)
  • Lists: Bullet points and numbered lists
  • Code Blocks: Syntax highlighting for 20+ languages
  • Links: Internal and external
  • Blockquotes: For quotes and callouts
  • Images: Single images with alt text
  • Image Gallery: Multiple images with captions
  • Video Embed: YouTube, Vimeo, or direct video files
  • Mermaid Diagrams: Flowcharts, sequence diagrams, etc.
  • Tables: Structured data presentation

Content Keyboard Shortcuts​

  • Cmd/Ctrl + B: Bold
  • Cmd/Ctrl + I: Italic
  • Cmd/Ctrl + K: Insert link
  • Cmd/Ctrl + Shift + 7: Bullet list
  • Cmd/Ctrl + Shift + 8: Numbered list
  • Cmd/Ctrl + Alt + 0: Paragraph
  • Cmd/Ctrl + Alt + 1-6: Headings

Media Library​

Accessing Media Library​

  1. Navigate to /admin/media
  2. Or click Media Library in admin sidebar

Uploading Media​

Method 1: Click Upload

  1. Click "Upload Media" button
  2. Select files from computer
  3. Wait for upload completion
  4. Files appear in grid

Method 2: Drag & Drop

  1. Open file explorer
  2. Drag files onto upload button
  3. Drop to upload

Supported Formats:

  • Images: JPG, PNG, GIF, WebP
  • Videos: MP4, WebM
  • Max Size: 10MB per file

Using Uploaded Media​

Copy Image URL:

  1. Hover over media card
  2. Click "Copy URL" button
  3. URL copied to clipboard
  4. Paste in content editor

Image Gallery Integration:

  1. Upload multiple related images
  2. Copy each URL
  3. Use Image Gallery block in editor
  4. Add each URL with captions

Organizing Media​

Best Practices:

  • Use descriptive filenames (blog-hero-ai-agents.jpg)
  • Optimize images before upload (< 500KB)
  • Consistent naming convention
  • Test URLs after copying

Cloudinary Transformations: Modify URLs for resizing:

https://res.cloudinary.com/.../w_500,h_300,c_fill/filename.jpg
  • w_500 = width 500px
  • h_300 = height 300px
  • c_fill = fill crop mode

Best Practices​

Content Structure​

Effective Outline:

  1. Hook (2-3 sentences grab attention)
  2. Problem Statement (what pain point does this solve?)
  3. Solution Overview (brief summary)
  4. Detailed Content (3-5 main sections)
  5. Key Takeaways (summary bullet points)
  6. Call-to-Action (next steps for reader)

Heading Hierarchy:

  • Use H2 for main sections
  • Use H3 for subsections
  • Don't skip heading levels
  • Be descriptive in headings

Writing Style​

Readability:

  • Active voice: "You can build" not "Can be built"
  • Second person: "You will learn"
  • Short paragraphs: 2-4 sentences
  • Transition between ideas
  • Use examples liberally

SEO Optimization:

  • Primary keyword in title
  • Primary keyword in first paragraph
  • Secondary keywords in H2 headings
  • LSI keywords throughout
  • Keywords in meta description

Content Quality Checklist​

Before publishing:

Technical:

  • Title is compelling and < 60 chars
  • Slug is URL-friendly
  • All required fields filled
  • Content is not empty
  • Links work (test all external links)
  • Code examples tested (if any)
  • Images load correctly

SEO:

  • Meta title < 60 chars with keywords
  • Meta description < 160 chars
  • 5-7 relevant tags added
  • Category selected
  • Featured image has alt text
  • Internal links added where relevant

Quality:

  • Grammar and spelling checked
  • Facts verified (especially technical)
  • Original insights added
  • Provides real value
  • Actionable takeaways included
  • Appropriate for target audience

Formatting:

  • Proper heading hierarchy
  • Short paragraphs
  • Lists for multiple items
  • Code blocks formatted
  • Images have captions

Content Types Guide​

Blog Posts (1200-1500 words)

  • Thought leadership and insights
  • Industry trends and analysis
  • Opinion pieces
  • Real-world applications
  • Structure: Hook → Problem → Solution → Examples → Conclusion

Tutorials (1500-2500 words)

  • Step-by-step instructions
  • Code examples with explanations
  • Prerequisites section
  • Troubleshooting tips
  • Structure: Objectives → Prerequisites → Steps → Testing → Next Steps

Lessons (1000-1500 words)

  • Educational content
  • Structured learning
  • Theory and practice
  • Quizzes or exercises
  • Structure: Learning Objectives → Content → Practice → Summary

Quick Tips (500-800 words)

  • Actionable advice
  • Fast wins
  • Specific solutions
  • Structure: Problem → Tip → Example → Result

Case Studies (1500-2000 words)

  • Real-world examples
  • Social proof
  • Results and metrics
  • Structure: Background → Challenge → Solution → Results → Lessons

Publishing Workflow​

Draft → Review → Publish

  1. Save as Draft

    • Work in progress
    • Not visible to public
    • Can be edited anytime

  2. Internal Review

    • Fact-check all claims
    • Test all code examples
    • Verify links
    • Check formatting
    • Run through quality checklist

  3. Publish

    • Click "Publish" button
    • Content goes live immediately
    • Visible based on access level
    • Can be unpublished anytime

Troubleshooting​

Common Issues​

"Content body is required"

  • Content editor is empty
  • Add at least one paragraph

"Title is required"

  • Title field is empty
  • Enter a compelling title

Images not loading

  • Check URL is complete and correct
  • Test URL in browser
  • Ensure HTTPS URL from Cloudinary
  • Check browser console for errors

Video not embedding

  • Verify YouTube/Vimeo URL format
  • Check URL is public (not private)
  • Try using embed URL instead of watch URL

Import JSON fails

  • Validate JSON syntax
  • Check required fields present
  • Verify enum values match schema
  • See SCHEMA_REFERENCE.md

Getting Help​

  1. Check this documentation
  2. Review AI_GENERATION.md for AI prompts
  3. See SCHEMA_REFERENCE.md for field details
  4. Check browser console for errors
  5. Test in different browser

Additional Resources​

Last Updated: December 2025