Categories

The categories property helps app stores, browsers, and platforms classify your PWA, making it easier for users to discover your application. It's a list of keywords that describe what your application does.

Purpose

Categories help with:

• App discovery: Users browsing by category find your app
• Search relevance: Improves searchability in app stores
• Store organization: Platforms group similar apps together
• User expectations: Sets correct expectations about functionality
• Recommendations: Powers "similar apps" suggestions

Configuration

/config/packages/pwa.yaml

pwa:
    manifest:
        enabled: true
        categories: ['productivity', 'business']

Best practices:

• Use lowercase for consistency
• Choose 1-3 most relevant categories
• Start with the primary category
• Categories are hints - platforms may use their own classification

Standard Categories

Business & Productivity

business

• CRM systems
• Project management
• Business analytics
• Invoice management

productivity

• Task managers
• Note-taking apps
• Time tracking
• Calendar applications

finance

• Banking apps
• Expense trackers
• Investment platforms
• Cryptocurrency wallets

developer / developer tools

• Code editors
• API clients
• DevOps dashboards
• Documentation browsers

Media & Entertainment

music

• Streaming services
• Music players
• Podcast apps
• Audio editors

video

• Video streaming
• Video editors
• YouTube clients
• Video conferencing

photo / photo & video

• Photo editors
• Image galleries
• Camera apps
• Photo sharing platforms

games

• All types of games
• Game launchers
• Gaming platforms

entertainment

• Streaming services
• Media centers
• Fun utilities
• Novelty apps

Social & Communication

social / social networking

• Social media platforms
• Community forums
• Messaging apps
• Social discovery

dating

• Dating apps
• Matchmaking platforms
• Relationship services

network / networking

• Professional networking
• Business connections
• Conference apps

Lifestyle & Health

health / health & fitness

• Fitness trackers
• Workout apps
• Health monitoring
• Wellness platforms

fitness

• Gym workout apps
• Running trackers
• Yoga and meditation
• Exercise planners

food

• Recipe apps
• Meal planners
• Nutrition trackers
• Restaurant finders

lifestyle

• General lifestyle apps
• Habit trackers
• Personal development
• Life organization

medical

• Medical records
• Symptom checkers
• Telemedicine
• Medical reference

Content & Learning

books / books & reference

• E-book readers
• Library apps
• Literary platforms
• Reading trackers

education

• Learning platforms
• Online courses
• Educational games
• Study tools

news

• News aggregators
• Newspapers
• RSS readers
• Breaking news alerts

magazines

• Magazine readers
• Periodical apps
• Article collections

reference

• Dictionaries
• Encyclopedias
• Lookup tools
• Information databases

Specialized

travel

• Trip planners
• Hotel booking
• Flight tracking
• Travel guides

navigation

• Maps
• GPS navigation
• Transit apps
• Location services

shopping

• E-commerce
• Price comparison
• Shopping lists
• Marketplace apps

sports

• Sports news
• Live scores
• Fantasy sports
• Team management

weather

• Weather forecasts
• Weather alerts
• Climate data
• Weather radar

utilities

• General utilities
• Calculators
• Converters
• System tools

Creative & Design

design

• Design tools
• Mockup creators
• UI/UX tools

graphics / graphics & design

• Graphic design
• Vector editors
• Image manipulation

multimedia / multimedia design

• Multi-media creation
• Audio/video editing
• Content production

Specialized Audiences

kids

• Child-appropriate content
• Educational games for children
• Parental controls included

parenting

• Parenting tips
• Baby trackers
• Family organization
• Child development tools

pets

• Pet care
• Vet finders
• Pet health trackers
• Animal adoption

Other

beauty

• Makeup tutorials
• Beauty tips
• Product reviews
• Style guides

cars / transportation

• Car maintenance
• Vehicle tracking
• Ride sharing
• Public transit

fashion

• Style guides
• Fashion shopping
• Outfit planning
• Trend tracking

events

• Event planning
• Ticket booking
• Event discovery
• Calendar integration

fundraising

• Donation platforms
• Crowdfunding
• Charity apps

government

• Government services
• Civic engagement
• Public records
• Official portals

personalization

• Customization tools
• Themes
• Wallpapers
• Launchers

politics

• Political news
• Campaign information
• Voting resources
• Political engagement

security

• Password managers
• VPN clients
• Security tools
• Privacy apps

Choosing the Right Categories

Single Primary Category

For highly focused apps:

categories: ['fitness']  # Workout tracking app
categories: ['music']    # Music streaming service
categories: ['games']    # Gaming platform

Multiple Related Categories

For apps spanning related areas:

# Health and fitness tracker
categories: ['health & fitness', 'lifestyle']

# Business collaboration tool
categories: ['productivity', 'business']

# Recipe and meal planner
categories: ['food', 'lifestyle']

# Photo editor and social sharing
categories: ['photo & video', 'social']

Avoid Over-Categorization

# ✗ Too many - dilutes focus
categories: ['productivity', 'business', 'utilities', 'lifestyle', 'social']

# ✓ Focused - clear purpose
categories: ['productivity', 'business']

Practical Examples

E-commerce App

pwa:
    manifest:
        name: "ShopEasy"
        description: "Shop online with great deals."
        categories: ['shopping']

Fitness Tracker

pwa:
    manifest:
        name: "FitTrack"
        description: "Track workouts and reach fitness goals."
        categories: ['health & fitness', 'sports']

Task Manager

pwa:
    manifest:
        name: "TaskMaster"
        description: "Organize tasks and boost productivity."
        categories: ['productivity', 'business']

News Reader

pwa:
    manifest:
        name: "NewsHub"
        description: "Stay updated with breaking news."
        categories: ['news']

Recipe App

pwa:
    manifest:
        name: "CookBook"
        description: "Discover and save delicious recipes."
        categories: ['food', 'lifestyle']

Social Network

pwa:
    manifest:
        name: "ConnectApp"
        description: "Connect with friends and family."
        categories: ['social networking', 'social']

Music Streaming

pwa:
    manifest:
        name: "MusicStream"
        description: "Stream millions of songs."
        categories: ['music', 'entertainment']

Weather App

pwa:
    manifest:
        name: "WeatherNow"
        description: "Accurate weather forecasts."
        categories: ['weather', 'utilities']

Developer Tools

pwa:
    manifest:
        name: "APITester"
        description: "Test and debug APIs easily."
        categories: ['developer tools', 'productivity']

Educational Platform

pwa:
    manifest:
        name: "LearnHub"
        description: "Interactive courses and tutorials."
        categories: ['education', 'books & reference']

Platform-Specific Behavior

Google Play Store

• Uses categories as hints
• May map to Play Store categories
• Helps with search and discovery
• Not guaranteed to match exactly

Microsoft Store

• Supports PWA categories
• Maps to Windows Store categories
• Influences app placement
• Used in search algorithms

App Stores in Browsers

• Chrome Web Store considers categories
• Edge Add-ons uses categories
• Other browser stores may vary

General Web

• May be ignored by some platforms
• Still useful for:

  • PWA directories
  • Third-party catalogs
  • Search engine optimization
  • Documentation/metadata

Best Practices

1. Be Specific

# ✗ Too generic
categories: ['utilities', 'productivity']

# ✓ Specific
categories: ['task management', 'productivity']

2. Primary Category First

# ✓ Most important category first
categories: ['health & fitness', 'lifestyle']

3. Limit to 2-3 Categories

# ✓ Focused
categories: ['finance', 'business']

# ✗ Too many
categories: ['finance', 'business', 'productivity', 'utilities', 'social']

4. Use Standard Categories

# ✓ Standard category
categories: ['productivity']

# ✗ Non-standard (may not be recognized)
categories: ['task-management-tools']

5. Match Your App's Purpose

Ensure categories align with your app's actual functionality:

# For a photo editing app
categories: ['photo & video', 'graphics']  # ✓ Accurate

# Not appropriate if your app doesn't do this
categories: ['games']  # ✗ Misleading

Common Mistakes

1. Using Too Many Categories

# ✗ Excessive
pwa:
    manifest:
        categories: ['productivity', 'business', 'utilities', 'tools', 'lifestyle', 'organization']

Impact: Dilutes app's focus, may be ignored by platforms

Fix:

# ✓ Focused
pwa:
    manifest:
        categories: ['productivity', 'business']

2. Mixing Specific and General

# ✗ Inconsistent specificity
categories: ['health & fitness', 'apps', 'mobile']

Fix:

# ✓ Consistent level
categories: ['health & fitness', 'lifestyle']

3. Using Non-Standard Names

# ✗ Custom categories not recognized
categories: ['super-productivity-tools', 'amazing-apps']

Fix:

# ✓ Standard categories
categories: ['productivity', 'business']

4. Wrong Capitalization

# ✗ Mixed case (inconsistent)
categories: ['Productivity', 'BUSINESS', 'health & Fitness']

Fix:

# ✓ Lowercase (standard)
categories: ['productivity', 'business', 'health & fitness']

5. Mismatched Categories

# ✗ Categories don't match app purpose
pwa:
    manifest:
        name: "MusicPlayer"
        description: "Stream your favorite music"
        categories: ['games', 'sports']  # Wrong!

Fix:

# ✓ Appropriate categories
pwa:
    manifest:
        name: "MusicPlayer"
        description: "Stream your favorite music"
        categories: ['music', 'entertainment']

Testing Categories

1. Validate in Manifest

// Check categories in your manifest
fetch('/manifest.json')
    .then(r => r.json())
    .then(manifest => {
        console.log('Categories:', manifest.categories);

        // Validate
        if (!manifest.categories || manifest.categories.length === 0) {
            console.warn('No categories specified');
        } else if (manifest.categories.length > 3) {
            console.warn('Too many categories - consider reducing to 2-3');
        }
    });

2. Check in DevTools

1. Open DevTools (F12)
2. Go to Application → Manifest
3. Check "categories" array
4. Verify categories are lowercase

3. Test Discovery

• Search for your app in stores by category
• Verify it appears in expected sections
• Check if similar apps are in same categories
• Test on multiple platforms (Play Store, Microsoft Store)

Category Selection Checklist

Before finalizing categories:

• Primary category accurately describes app
• Using 1-3 categories maximum
• All categories are lowercase
• Categories are from standard list
• No overly generic categories (e.g., just "apps")
• Categories match app description
• Tested in app stores/platforms
• Similar to competitor categorization
• Makes sense to target users

SEO and Discovery Impact

Categories affect:

1. Store Search: Apps appear in category searches
2. Browse Discovery: Users browsing categories find your app
3. Similar Apps: Powers "you might also like" features
4. Filtering: Enables category-based filtering
5. Rankings: May influence category-specific rankings

Related Properties

• Description - Describes app functionality
• IARC Rating - Age and content rating
• Name - App identification

Summary

Category selection best practices:

• ✓ Choose 1-3 most relevant standard categories
• ✓ Put primary category first
• ✓ Use lowercase for consistency
• ✓ Match categories to actual functionality
• ✓ Use specific categories when possible
• ✓ Check against standard category list
• ✗ Don't use more than 3 categories
• ✗ Don't make up custom categories
• ✗ Don't use misleading categories
• ✗ Don't forget to test on actual platforms