Blog Entity

v2.0.1

Creative Work

Media Entertainment

Schema for blog platforms based on the content publishing subcategory. Designed for AI agents to understand content structure, publication patterns, and reader interaction capabilities.

Entity Hierarchy

Blog

→

creative_work

→

media_entertainment

→

blog

Format: @type → entityCategory → subcategory → entityType

Required Modules

Recommended Modules

12+

Functional Features

Site Actions

⭐ New Features in v2.0.1

Perfect AI understanding with zero ambiguity

entityCapabilities

Objective, verifiable blog features with rules:

• camelCase (hasComments, hasSubscription)
• Prefixes: has, is, accepts, supports
• Boolean values for objective verification
• Examples expandable - no limitations

siteCapabilities

Actions available on blog site with rules:

• snake_case (read_article, search_content)
• Based on verbs (what users can do)
• Only actually working actions
• Examples expandable without limitations

Recommended Modules

Enhance blog functionality and user experience

Recommended

auth

Recommended

multilingual

Recommended

user-management

No Required Modules

Blog entities have complete flexibility in module selection

Blogs can operate with any combination of modules based on their specific needs and features. The recommended modules enhance functionality but are not mandatory.

Entity Capabilities

Objective, verifiable blog features and services. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".

Naming Convention Rules

• Use camelCase formatting (e.g., "hasComments", "hasSubscription")
• Start with prefixes: "has", "is", "accepts", "supports"
• Examples shown below can be extended - no limitations on additional capabilities
• All values are boolean (true/false) for objective verification

Content Management

hasComments

User comments on posts

hasRSSFeed

RSS/Atom feed available

hasArchive

Historical content archive

hasTagging

Content categorization system

User Engagement

hasSubscription

Newsletter/email subscription

hasSocialSharing

Social media integration

hasUserProfiles

Reader profile system

acceptsGuestPosts

Community contributions

Discovery Features

hasSearchFunction

Content search capability

hasNewsletter

Regular email updates

hasCategoryFilter

Content filtering by topic

hasRelatedPosts

Content recommendation

Site Capabilities

Available actions for AI agents and automated systems. Define what users can actually do on your blog using snake_case action names.

Action Naming Rules

• Use snake_case formatting (e.g., "read_article", "search_content")
• Actions should be verb-based describing what users can do
• Examples shown below are common patterns - extend with your specific actions
• List only actions that actually work on your website

read_article

View blog posts and articles

search_content

Search through blog content

subscribe_newsletter

comment_on_post

Leave comments on articles

share_article

Share content on social media

bookmark_post

Save articles for later reading

filter_by_category

Browse content by topic

view_author_profile

Learn about content authors

Schema Structure

Blog entity schema definition

blog.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "title": "Blog Entity Schema",
  "description": "Schema for blog platforms based on the content publishing subcategory",
  "type": "object",
  "properties": {
    "entityType": {
      "const": "blog",
      "description": "Entity type identifier"
    },
    "entityCategory": {
      "const": "creative_work",
      "description": "Entity category"
    },
    "subcategory": {
      "const": "media_entertainment",
      "description": "Subcategory of creative work"
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Blog name"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Detailed description of the blog"
    },
    "modules": {
      "type": "object",
      "description": "AIML modules used by this entity"
    },
    "properties": {
      "type": "object",
      "description": "Blog specific properties",
      "properties": {
        "postFrequency": {
          "type": "string",
          "description": "How often new content is published"
        },
        "contentCategories": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Main content categories covered"
        }
      }
    },
    "entityCapabilities": {
      "$ref": "../components/entity-capabilities-format.json#/$defs/EntityCapabilities",
      "description": "Objective capabilities and features of the entity"
    },
    "siteCapabilities": {
      "$ref": "../components/site-capabilities-format.json#/$defs/SiteCapabilities",
      "description": "Website capabilities and interaction features"
    }
  },
  "required": ["entityType", "entityCategory", "subcategory", "name", "description", "properties"],
  "allOf": [{ "$ref": "../base/creative_work.json" }]
}

Complete Implementation Example

Real-world blog entity with all v2.0.1 features

TechBlog Daily - Complete Schema

{
  "@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
  "@id": "https://techblog.com/entity",
  "@type": "Blog",
  "schemaVersion": "2.0.1",
  "entityType": "blog",
  "entityCategory": "creative_work",
  "subcategory": "media_entertainment",

  "name": {
    "en": "TechBlog Daily",
    "es": "TechBlog Diario"
  },
  "description": {
    "en": "Leading technology blog covering latest trends in AI, blockchain, and software development with expert insights and tutorials."
  },
  "url": "https://techblog.com",
  "foundingDate": "2019-03-01",

  "properties": {
    "postFrequency": "daily",
    "contentCategories": ["technology", "artificial_intelligence", "blockchain", "software_development"],
    "authorCount": 12,
    "languagesSupported": ["en", "es"]
  },

  "modules": {
    "auth": {
      "version": "2.0.1",
      "enabled": true,
      "methods": ["email", "social"],
      "providers": ["local", "google", "github"]
    },
    "search": {
      "version": "2.0.1",
      "enabled": true,
      "features": ["full_text_search", "category_filter", "tag_search"]
    },
    "user-management": {
      "version": "2.0.1",
      "enabled": true,
      "roles": ["reader", "subscriber", "contributor", "admin"],
      "features": ["profiles", "preferences", "reading_history"]
    }
  },

  "entityCapabilities": {
    "functionalFeatures": {
      "hasComments": true,
      "hasSubscription": true,
      "hasNewsletter": true,
      "hasRSSFeed": true,
      "hasSocialSharing": true,
      "hasSearchFunction": true,
      "hasArchive": true,
      "hasTagging": true,
      "hasUserProfiles": true,
      "acceptsGuestPosts": false
    },
    "contentTypes": ["articles", "tutorials", "reviews", "news", "videos"],
    "businessModel": "content_platform",
    "contentCategories": ["technology", "ai", "blockchain", "development"],
    "publicationFrequency": "daily",
    "targetAudience": ["developers", "tech_professionals", "students"]
  },

  "siteCapabilities": {
    "availableActions": [
      "read_article", "search_content", "subscribe_newsletter",
      "comment_on_post", "share_article", "bookmark_post",
      "filter_by_category", "view_author_profile"
    ],
    "interactionMethods": ["online_form", "email", "social_media"],
    "contentAccess": ["public", "subscriber_only"],
    "supportedDevices": ["desktop", "mobile", "tablet"],
    "languages": ["en", "es"],
    "realTimeFeatures": ["live_comments", "notification_system"]
  }
}