Recipe Category Documentation¶
Menu Location: Settings > Content & Marketing > Recipe Category
Access Level: Manager and above
Last Updated: 2026-03-01
Overview¶
The Recipe Category page allows you to create, manage, and organize the category structure used to classify recipes on your website. Well-organized categories help customers browse and discover recipes based on meal type, cuisine, dietary preferences, cooking method, and seasonality.
Primary Functions:
- Create and edit recipe categories
- Organize categories hierarchically (parent/child relationships)
- Assign display order for category browsing
- Set category images and descriptions
- Enable/disable categories for seasonal rotation
- Track recipe count per category
- Customize category URLs for SEO
Page Layout¶
Header Section¶
- Add New Category button: Creates new category
- Search Bar: Find categories by name
- View Toggle: Tree view (hierarchical) or List view (flat)
- Sort Options: Alphabetical, by recipe count, by display order
Category List¶
Displays all categories with columns:
- Category Name (clickable to edit)
- Parent Category (if subcategory)
- Recipe Count - Number of recipes assigned
- Status - Active or Inactive
- Display Order - Position in navigation
- Actions - Edit, Delete, View Recipes buttons
Category Editor (when editing)¶
- Basic Information section
- Parent Category selector (for creating subcategories)
- Display Settings section
- SEO Settings section
- Category Image uploader
- Save/Delete buttons
Creating Categories¶
Basic Category Creation¶
Steps:
- Click "Add New Category" button
- Enter category name (e.g., "Dinner Recipes")
- (Optional) Select parent category if creating subcategory
- Write category description (1-2 sentences)
- Upload category image (optional but recommended)
- Set display order number
- Choose status (Active or Inactive)
- Click "Save Category"
Required Fields:
- Category Name (must be unique)
- Status (Active/Inactive)
Category Naming Best Practices¶
Good Category Names:
- Clear and descriptive: "Breakfast Recipes"
- Customer-friendly language: "Quick Weeknight Dinners"
- SEO-optimized: "Gluten-Free Recipes"
- Specific but not too narrow: "Italian Recipes" not "Spaghetti Carbonara Recipes"
Avoid:
- Vague names: "Miscellaneous", "Other"
- Overly long names: "Quick and Easy Recipes for Busy Weeknight Dinners Under 30 Minutes"
- Duplicate names: Check existing categories first
- Internal jargon: Use customer-facing language
Category Hierarchy¶
Parent and Child Categories¶
Purpose of Hierarchy:
- Organize related categories together
- Create browsable category navigation
- Allow broad and specific filtering
- Improve user experience
Common Hierarchy Examples:
Meal Type Structure:
- Breakfast Recipes (parent)
- Eggs & Omelets (child)
- Pancakes & Waffles (child)
- Breakfast Breads (child)
- Smoothies & Bowls (child)
Cuisine Structure:
- International Recipes (parent)
- Italian Recipes (child)
- Mexican Recipes (child)
- Asian Recipes (child)
- Mediterranean Recipes (child)
Dietary Structure:
- Special Diets (parent)
- Vegetarian Recipes (child)
- Vegan Recipes (child)
- Gluten-Free Recipes (child)
- Paleo Recipes (child)
Creating Subcategories¶
Steps:
- Click "Add New Category"
- Enter category name
- In "Parent Category" dropdown, select parent
- Complete other fields
- Save
- Subcategory appears nested under parent in tree view
Hierarchy Tips:
- Limit to 2 levels deep (parent and child only)
- Don't create too many subcategories (5-8 per parent ideal)
- Ensure subcategories are mutually exclusive when possible
- Consider customer browsing patterns
Display Order & Organization¶
Setting Display Order¶
Purpose: Control the sequence categories appear in navigation menus and browsing pages.
How It Works:
- Each category has a display order number
- Lower numbers appear first (1, 2, 3...)
- Categories without order number appear last
- Applies within same hierarchy level
Example Display Order:
- Breakfast Recipes (order: 10)
- Lunch Recipes (order: 20)
- Dinner Recipes (order: 30)
- Desserts (order: 40)
- Snacks & Appetizers (order: 50)
Ordering Strategy:
- Use increments of 10 to allow easy insertion later
- Order by importance or popularity
- Group related categories together
- Consider customer journey (breakfast to dinner)
Reordering Categories¶
Drag and Drop Method:
- Switch to Tree View
- Click and hold category name
- Drag to new position
- Release to drop
- Order numbers update automatically
Manual Method:
- Edit category
- Change "Display Order" number
- Save
- Refresh page to see new order
Category Images & Descriptions¶
Category Images¶
Image Purpose:
- Visual appeal in category browsing
- Help customers quickly identify category type
- Improve engagement and click-through
- Brand consistency across recipe section
Image Requirements:
- Recommended size: 800x600px (4:3 ratio)
- File format: JPG or PNG
- File size: Under 1MB
- Content: Representative dish from category or lifestyle image
Uploading Category Image:
- Edit category
- Scroll to "Category Image" section
- Click "Upload Image" button
- Select file from computer
- Add alt text describing the image
- Save
Image Best Practices:
- Use high-quality, professional photos
- Consistent style across all categories
- Images should represent category theme
- Optimize file sizes for fast loading
Category Descriptions¶
Purpose:
- Help customers understand category content
- Improve SEO (search engines index descriptions)
- Set expectations for recipes in category
- Provide context and inspiration
Writing Good Descriptions:
- Keep to 1-3 sentences (50-150 characters)
- Include key search terms naturally
- Describe types of recipes in category
- Mention key characteristics (quick, healthy, seasonal)
Examples:
Good: "Quick and delicious breakfast recipes to start your day right. From hearty omelets to fresh smoothie bowls, find your perfect morning meal in under 30 minutes."
Too Vague: "Recipes for breakfast."
Too Long: "This category contains all of our breakfast recipes including eggs, pancakes, waffles, French toast, breakfast burritos, smoothies, oatmeal, yogurt parfaits, and everything else you might want to eat for breakfast whether it's a weekday or weekend morning."
Category Status Management¶
Active Status¶
Active categories:
- Visible on website navigation
- Appear in recipe browsing
- Included in search filters
- Recipes can be assigned to category
Use for:
- Categories with published recipes
- Year-round recipe types
- Currently promoted categories
Inactive Status¶
Inactive categories:
- Hidden from website navigation
- Not shown in browsing
- Not available in search filters
- Recipes remain assigned but don't display in category
Use for:
- Seasonal categories in off-season
- Categories being reorganized
- Categories with no recipes yet
- Discontinued category types
Note: Inactivating a category doesn't delete recipes or remove category assignments. It just hides the category from customers.
Seasonal Category Rotation¶
Strategy for Seasonal Content:
Winter (Dec-Feb):
- Activate: Winter Recipes, Holiday Baking, Warm Soups, Comfort Food
- Deactivate: Summer Grilling, Cold Salads, Refreshing Drinks
Spring (Mar-May):
- Activate: Spring Recipes, Fresh Salads, Easter Recipes
- Deactivate: Winter Soups, Holiday Baking
Summer (Jun-Aug):
- Activate: Summer Recipes, Grilling, Cold Salads, Refreshing Drinks
- Deactivate: Winter Soups, Comfort Food
Fall (Sep-Nov):
- Activate: Fall Recipes, Thanksgiving, Harvest Recipes
- Deactivate: Summer Grilling, Refreshing Drinks
Tip: Schedule category status changes in advance to automate seasonal rotation.
SEO Settings for Categories¶
Category URL Slug¶
Purpose: The URL slug is the web address for the category page.
Example:
- Category Name: "Quick Weeknight Dinners"
- URL Slug: quick-weeknight-dinners
- Full URL: yoursite.com/recipes/quick-weeknight-dinners
Slug Best Practices:
- Lowercase letters only
- Use hyphens, not spaces or underscores
- Keep short but descriptive
- Include primary keyword
- Once published, don't change (breaks bookmarks and links)
Auto-Generation: System automatically creates slug from category name if left blank.
Meta Title¶
Purpose: Appears in search engine results and browser tab.
Guidelines:
- Maximum 60 characters
- Include primary keyword
- Front-load important words
- Add brand name at end if space allows
Example: "Quick Weeknight Dinner Recipes | FarmBox"
Auto-fills from category name if left blank
Meta Description¶
Purpose: Appears in search results below title. Influences click-through rate.
Guidelines:
- Maximum 160 characters
- Compelling summary of category content
- Include keywords naturally
- Call to action (Browse, Discover, Find)
Example: "Discover 50+ quick and delicious weeknight dinner recipes ready in 30 minutes or less. Farm-fresh ingredients, easy instructions, perfect for busy families."
Category Keywords¶
Focus Keywords: Primary search terms you want category to rank for.
Example for "Vegetarian Recipes":
- Primary: vegetarian recipes
- Secondary: plant-based meals, meatless dinners
- Related: healthy vegetarian, easy vegetarian
Keyword Tips:
- Research what customers actually search for
- Use Google Trends or keyword tools
- Include keywords in description naturally
- Don't keyword stuff (hurts SEO)
Common Use Cases¶
Use Case 1: Create New Seasonal Category¶
Goal: Add "Summer Grilling Recipes" category for grilling season
Steps:
- Click "Add New Category"
- Enter name: "Summer Grilling Recipes"
- Write description: "Fire up the grill with these delicious summer recipes featuring fresh vegetables, lean proteins, and bold flavors."
- Upload grilling-themed image
- Select parent: "Seasonal Recipes"
- Set display order: 30
- Status: Active
- URL slug: summer-grilling-recipes
- Meta title: "Summer Grilling Recipes | Outdoor Cooking"
- Meta description: "Transform your backyard BBQ with 40+ summer grilling recipes. Fresh farm ingredients, easy techniques, crowd-pleasing flavors."
- Save category
- Assign relevant recipes to new category
Tip: Create matching email campaign featuring recipes in new category
Use Case 2: Reorganize Category Structure¶
Goal: Improve category organization based on customer feedback
Current Structure Problems:
- Too many top-level categories (overwhelming)
- Some categories have too few recipes
- Customer confusion about where to find recipes
Reorganization Steps:
- Review current categories and recipe counts
- Identify underused categories (fewer than 5 recipes)
- Plan new hierarchy on paper first
- Create new parent categories as needed
- Move recipes from old to new categories
- Update subcategory parent assignments
- Deactivate old categories
- Test navigation from customer perspective
- Update any marketing materials referencing old categories
- Monitor analytics to measure improvement
Example Reorganization:
Before:
- Breakfast (8 recipes)
- Eggs (3 recipes)
- Pancakes (2 recipes)
- Lunch (6 recipes)
- Sandwiches (4 recipes)
- Salads (12 recipes)
After:
- Breakfast Recipes (parent, 13 recipes total)
- Eggs & Omelets (child, 3 recipes)
- Pancakes & Waffles (child, 2 recipes)
- Other Breakfast (child, 8 recipes)
- Lunch Recipes (parent, 22 recipes total)
- Sandwiches & Wraps (child, 4 recipes)
- Fresh Salads (child, 12 recipes)
- Soups & Sides (child, 6 recipes)
Use Case 3: Create Dietary Restriction Categories¶
Goal: Make it easy for customers to find recipes matching their dietary needs
Categories to Create:
- Special Diets (parent category)
- Vegetarian Recipes (child)
- Vegan Recipes (child)
- Gluten-Free Recipes (child)
- Dairy-Free Recipes (child)
- Paleo Recipes (child)
- Keto/Low-Carb Recipes (child)
Implementation Steps:
- Create "Special Diets" parent category
- Create each dietary restriction as child category
- Write descriptive descriptions including benefits
- Add appropriate keywords for SEO
- Upload representative images for each
- Set logical display order (most popular first)
- Tag existing recipes with appropriate dietary categories
- Promote new categories in newsletter
- Add dietary filter to recipe search
- Monitor usage to identify most-requested diets
Tip: Recipes can belong to multiple dietary categories (e.g., Vegan AND Gluten-Free)
Use Case 4: Rotate Seasonal Categories¶
Goal: Hide summer categories as fall approaches, activate fall categories
End of Summer Checklist:
- Filter categories by "Summer" tag
- Change status to "Inactive" for:
- Summer Grilling Recipes
- Cold Summer Salads
- Refreshing Summer Drinks
- Summer Berry Desserts
- Filter categories by "Fall" tag
- Change status to "Active" for:
- Fall Harvest Recipes
- Warm Comfort Foods
- Thanksgiving Recipes
- Apple & Pumpkin Recipes
- Update homepage featured category to fall category
- Create "Welcome Fall" recipe collection
- Send email highlighting activated fall categories
- Monitor most popular fall recipes for homepage feature
Automation Option: Set scheduled status changes so categories automatically activate/deactivate on specific dates.
Use Case 5: Merge Duplicate or Overlapping Categories¶
Goal: Consolidate similar categories to reduce confusion
Scenario:
- "Chicken Recipes" (23 recipes)
- "Chicken Dinners" (18 recipes)
- "Easy Chicken" (12 recipes)
Too much overlap confuses customers
Consolidation Steps:
- Decide on primary category name: "Chicken Recipes"
- Review all recipes in the 3 categories
- Assign all recipes to "Chicken Recipes" category
- Update "Chicken Recipes" description to be comprehensive
- Add subcategories if needed:
- Quick Chicken (under 30 min)
- Grilled Chicken
- Baked Chicken
- Chicken Soups & Stews
- Delete or archive old duplicate categories
- Update any links or promotions
- Set up 301 redirects from old category URLs to new one
Result: Cleaner navigation, all chicken recipes in one place, better user experience
Troubleshooting¶
Category Not Appearing on Website¶
Symptoms:
- Category shows as Active in admin but not visible to customers
Check:
- Verify status is "Active" not "Inactive"
- Ensure category has at least one published recipe assigned
- Check if parent category (if subcategory) is also Active
- Clear website cache
- Verify category isn't excluded in theme settings
- Check if category display is enabled in website settings
Common Causes:
- No published recipes in category (system hides empty categories)
- Parent category is Inactive
- Website cache not cleared
- Category marked as "Admin Only"
Recipes Not Showing in Category¶
Symptoms:
- Category page shows no recipes even though recipes are assigned
Solutions:
- Edit recipes and verify category is checked
- Ensure recipes are Published (not Draft)
- Check if recipes are dated (publish date in future)
- Clear website cache
- Verify recipes aren't filtered out by other criteria
- Check database integrity (admin access required)
Testing:
- View recipe in admin - does it show category assigned?
- View recipe on website - does category link work?
- View category in admin - does recipe count match?
Category URL Not Working (404 Error)¶
Symptoms:
- Clicking category link shows "Page Not Found"
Check:
- Verify URL slug doesn't have spaces or special characters
- Check for duplicate URL slugs
- Ensure category is Active
- Clear URL rewrite cache
- Verify .htaccess rules are correct (Kiva admin)
- Check if category URL structure changed
If Recently Changed Slug:
- Set up 301 redirect from old URL to new URL
- Update any marketing materials with old link
- Update internal links in other recipes
Category Image Not Displaying¶
Symptoms:
- Image shows in admin but broken on website
- Slow loading or missing image
Solutions:
- Verify image file size under 1MB
- Check image format (JPG or PNG only)
- Re-upload image
- Clear CDN cache
- Verify image URL is correct
- Check file permissions on server
Image Optimization:
- Use image compression tools before upload
- Ensure dimensions are reasonable (800x600px recommended)
- Convert HEIC or other formats to JPG
Related Pages¶
- Recipes - Create and manage individual recipes
- Recipe Tags - Additional tagging system beyond categories
- Media Library - Upload and manage category images
- Email Templates - Feature categories in newsletters
- Front Page - Display featured categories on homepage
Typical Workflow:
- Recipe Categories � Create category structure
- Media Library � Upload category images
- Recipes � Create recipes and assign to categories
- Recipe Categories � Adjust display order and organization
- Front Page � Feature categories on homepage
- Email Templates � Promote categories in campaigns
Permissions & Access¶
Required Access Level: Manager or higher
Access Level Capabilities:
- Manager: Create, edit, activate/deactivate categories
- Administrator: All Manager + delete categories, reorganize structure
- Kiva Admin: All features + advanced SEO, bulk operations
Restricted Features:
- Delete Category: Requires Administrator (must reassign recipes first)
- SEO Settings: Available to Manager, advanced options require Admin
- Bulk Operations: Administrator or Kiva Admin
Best Practices¶
Category Planning¶
- Start with broad categories before creating subcategories
- Limit top-level categories to 6-10 for easy navigation
- Think like a customer not an internal team member
- Use data to inform structure - what are customers searching for?
- Plan for growth - structure should scale as recipe library grows
Organization¶
- Keep hierarchy shallow - maximum 2 levels (parent/child)
- Ensure categories are distinct - minimize overlap
- Balance category sizes - avoid 1 huge category and many tiny ones
- Use consistent naming across similar categories
- Regular audits - review and refine quarterly
SEO & Discoverability¶
- Research keywords before naming categories
- Write unique meta descriptions for each category
- Optimize category images with descriptive alt text
- Create clear URL slugs that reflect category content
- Internal linking - link between related categories in descriptions
User Experience¶
- Clear naming - customers should immediately understand category
- Intuitive organization - categories where customers expect them
- Consistent images - similar style across all categories
- Mobile-friendly - test category navigation on phones
- Search integration - categories should work well with site search
Seasonal Management¶
- Plan seasonal rotation in advance
- Deactivate (don't delete) off-season categories
- Reuse categories year after year (preserve content)
- Update images seasonally to keep fresh
- Promote seasonal categories in marketing
Things to Avoid¶
- ❌ Too many categories (overwhelming customers)
- ❌ Categories with only 1-2 recipes (appears incomplete)
- ❌ Overly specific categories (too narrow)
- ❌ Inconsistent naming conventions
- ❌ Deleting categories (archive instead to preserve structure)
- ❌ Ignoring SEO optimization (missed traffic opportunity)
- ❌ Setting and forgetting (requires ongoing management)
Quick Reference Card¶
| Task | Action/Location |
|---|---|
| Create new category | Click "Add New Category" button |
| Edit existing category | Click category name in list |
| Create subcategory | New category > Select parent from dropdown |
| Upload category image | Edit category > "Upload Image" button |
| Reorder categories | Drag category in tree view OR set display order number |
| Activate category | Edit category > Status: Active > Save |
| Deactivate category | Edit category > Status: Inactive > Save |
| View recipes in category | Click recipe count number in category list |
| Delete category | Edit category > "Delete" (must reassign recipes first) |
| Set SEO settings | Edit category > SEO Settings section |
| Create hierarchy | New category > Parent Category dropdown > Select parent |
FAQs¶
How many categories should I have?¶
Start with 8-12 top-level categories covering broad topics. Add subcategories as needed to organize large categories. Too many categories overwhelms customers; too few makes browsing difficult.
Can a recipe belong to multiple categories?¶
Yes! Recipes should be assigned to all relevant categories. For example, "Grilled Vegetable Skewers" could be in Summer Recipes, Vegetarian, Grilling, and Side Dishes.
What happens to recipes when I delete a category?¶
You must reassign recipes to a different category before deleting. System prevents deletion if recipes are still assigned. Consider archiving instead of deleting.
Should I use categories or tags?¶
Both! Categories provide main navigation structure (visible in menus). Tags add granular filtering (search facets). Categories are broader, tags are specific.
How often should I update categories?¶
Review quarterly for accuracy. Update seasonally to activate/deactivate seasonal categories. Add new categories as content grows, but avoid constant reorganization (confuses customers).
Can customers see inactive categories?¶
No, inactive categories are completely hidden from customers. Recipes remain assigned but category doesn't appear in navigation, browsing, or search filters.
What's the difference between parent and child categories?¶
Parent categories are top-level (main navigation). Child categories (subcategories) appear nested under parents. Example: "Breakfast" (parent) contains "Eggs & Omelets" (child).
Should I include recipe count in category name?¶
No, the system automatically displays recipe counts. Keep category names clean and timeless. Recipe counts update automatically as recipes are added/removed.
How do I handle categories with no recipes?¶
Either add recipes to the category or mark it as Inactive until you have content. Don't show empty categories to customers (looks unfinished).
Can I import categories from another system?¶
Contact Kiva Logic support for bulk category import. For small numbers, manual creation is quickest. Plan structure before creating to avoid reorganization later.
End of Documentation
For additional help, contact your system administrator or Kiva Logic support.