Introduction
What is WebbyBlog?
WebbyBlog is a comprehensive, production-ready blog plugin for Strapi CMS that provides everything you need to create and manage a professional blog without writing a single line of code for content types, routes, or controllers.
Key Features
Zero Configuration
Install the plugin and start creating content immediately. No manual setup of content types, routes, or controllers required.
Rich Content Editor
Create engaging blog posts with rich text editor and flexible content blocks including images, videos, galleries, FAQs, and more.
Flexible Taxonomy
Organize your content with categories and tags. Each post can belong to a category and have multiple tags for better organization.
SEO Optimized
Built-in SEO fields including meta title, description, and keywords to help your content rank better in search engines.
RESTful API
Complete REST API out of the box with slug-based routes for clean URLs. All endpoints follow Strapi’s standard conventions.
Author Management
Track content authors with built-in user relations. Perfect for multi-author blogs and content attribution.
View Tracking
Built-in view counter to track post popularity and engagement metrics.
Production Ready
Built with security, validation, and best practices in mind. Ready for production use from day one.
Requirements
Before installing WebbyBlog, make sure you have:
- Node.js >= 20.0.0
- npm >= 8.0.0
- Strapi >= 5.0.0
Use Cases
WebbyBlog is perfect for:
- Company Blogs – Share company news, updates, and insights
- Personal Blogs – Create your personal blog or portfolio
- News Websites – Publish articles and news stories
- Documentation Sites – Create documentation with blog-style posts
- Educational Content – Share tutorials, guides, and educational materials
- Marketing Content – Publish marketing articles and case studies
Ready to get started? Check out the Installation tab to begin setting up WebbyBlog in your Strapi project.
Installation
Get started with WebbyBlog plugin installation and setup
Install the Package
npm i @webbycrown/webbyblogyarn add @webbycrown/webbyblogEnable in Strapi
Add the plugin configuration to your config/plugins.js file:
// config/plugins.js
module.exports = ({ env }) => ({
'webbyblog': {
enabled: true,
resolve: '@webbycrown/webbyblog',
},
});Note: After adding the plugin configuration, restart your Strapi server to load the plugin.
Local Development
If you’re developing locally or want to use a local version of the plugin, you can enable it from the local path:
// config/plugins.js
module.exports = ({ env }) => ({
'webbyblog': {
enabled: true,
resolve: './src/plugins/webbyblog',
},
});Initial Setup Steps
- Enable the Plugin: Add the plugin configuration to
config/plugins.js(see above) - Restart Strapi: Restart your Strapi server to load the plugin
- Access Admin Panel:
- Go to Strapi Admin → Settings → WebbyBlog
- Configure your settings if needed
- Start Creating Content:
- Navigate to Content Manager
- You’ll see Blog Post, Blog Category, and Blog Tag content types
- Start creating your blog content!
Verification
To verify the installation was successful:
- Check that the plugin appears in Settings → Plugins
- Verify that three new content types appear in Content Manager:
- Blog Post
- Blog Category
- Blog Tag
- Test the API endpoints (see API Reference page)
Success! If you can see the content types and access the settings page, your installation is complete. You can now proceed to create content or check out the Seed Data tab to populate your blog with demo content.
Troubleshooting
Plugin not appearing?
- Make sure you’ve restarted the Strapi server after adding the configuration
- Check that the package is installed:
npm list @webbycrown/webbyblog - Verify the configuration syntax in
config/plugins.jsis correct
Content types not showing?
- Ensure the plugin is enabled in the configuration
- Check the Strapi server logs for any errors
- Try rebuilding the admin panel:
npm run build
Seed Data
Populate your blog with demo data for testing and development
Why Use Seed Data?
Seed data is useful for:
- Testing the plugin functionality
- Getting started quickly with sample content
- Understanding the data structure
- Demonstrating features to clients or stakeholders
Running the Seed Script
To seed your blog with demo data, you can use either method:
Using script:
npm run seed:blogyarn seed:blogOr directly with node:
node scripts/seed-blog.jsNote: Make sure you’re running the command from your Strapi project root directory, not from the plugin directory.
What Gets Seeded
The seed script creates a complete set of demo content:
Categories (5 categories):
- Technology – Tech-related posts
- Web Development – Web development topics
- Design – Design and UI/UX content
- Business – Business and entrepreneurship
- Lifestyle – Lifestyle and personal topics
Tags (10 tags):
- Technology Tags: JavaScript, React, Node.js, CSS, HTML
- Content Type Tags: Tutorial, Tips, Best Practices
- Level Tags: Beginner, Advanced
Sample Blog Posts:
- Multiple blog posts with full content
- Properly linked to categories and tags
- Includes SEO meta fields (title, description, keywords)
- Sample content blocks demonstrating all block types
- Featured images (if configured)
- Author assignments
- Published dates
Idempotent Operation
Important: The script is idempotent – it won’t create duplicates. If a category, tag, or post already exists (matched by name/slug), it will be skipped. This means you can run the script multiple times safely without creating duplicate content.
Seed Script Options
The seed script supports several command-line options:
Help
// Run with help
npm run seed:blog -- --help
// or
node scripts/seed-blog.js --helpDisplays all available options and usage information.
Non-Interactive Mode
// Run in non-interactive mode (skip confirmations)
npm run seed:blog -- --yes
// or
node scripts/seed-blog.js --yesRuns the script without prompting for confirmation. Useful for automated setups.
Before Running the Seed Script
Make sure you have:
- Installed and enabled the WebbyBlog plugin (see Installation tab above)
- Started your Strapi server at least once
- Created at least one admin user (for author assignment)
- Ensured your database is accessible
After Seeding
Once the seed script completes successfully:
- Check the Content Manager to see the created content
- Verify categories, tags, and posts are properly linked
- Test the API endpoints (see API Reference)
- Review the content structure to understand how to create your own content
Clearing Seed Data
To remove seed data:
- Go to Content Manager in Strapi admin
- Delete the blog posts, categories, and tags manually
- Or use the Strapi API to delete items programmatically
Warning: Deleting categories or tags that are linked to posts may cause issues. Make sure to unlink or delete related posts first, or handle the relationships appropriately.
Customizing Seed Data
If you want to customize the seed data:
- Locate the seed data file:
server/src/data/blog-seed-data.json - Modify the JSON structure to match your needs
- Run the seed script again
Tip: The seed data includes realistic content that demonstrates all features of the plugin. Use it as a reference for creating your own content structure.