Source of truth for implementation is the canonical schema host: https://schemas.meta-aiml.org/v3.0.0/. If any page text conflicts with canonical schema files, follow canonical files. Documentation home.

SocialNetwork

v3.0.0

DigitalEntity

Social

v3 schema for social networking platforms where the primary value source is user-generated content and graph interactions among participants.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

Contract URL: https://schemas.meta-aiml.org/v3.0.0/entity/social_network.json

Example URL: https://schemas.meta-aiml.org/v3.0.0/examples/social_network_example_schema_v3.json

Inheritance Chain

https://schemas.meta-aiml.org/v3.0.0/ontology/digital_entity.json

https://schemas.meta-aiml.org/v3.0.0/archetypes/network_graph.json

Interaction archetype

NetworkGraph

Required Top-level Fields

These fields are enforced by JSON Schema required[] at root level.

@type

ontologicalMode

interactionArchetype

domain

name

description

deliveryFormat

capabilities

structuralMetadata

modules

Non-universal required fields

interactionArchetype

Entity-specific Properties

Keys under properties.properties dedicated to this entity contract.

connectionModel

contactPoints

feedRankingModel

identifiers

moderationModel

socialProfiles

supportsCreatorMonetization

supportsPrivateCommunities

Modules Contract

Required modules

No required modules for this entity.

Optional modules

distribution

identity

moderation

Capabilities Contract

Required capability groups

interaction

content

community

Optional capability groups

financial

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-SOCN-001: @type MUST equal "SocialNetwork"

RULE-SOCN-002: ontologicalMode MUST equal "DigitalEntity"

RULE-SOCN-003: interactionArchetype MUST contain "NetworkGraph"

RULE-SOCN-004: capabilities MUST include interaction, content, community

RULE-SOCN-005: structuralMetadata.valueSource MUST equal "user_generated"

RULE-SOCN-006: structuralMetadata.networkEffects MUST equal "same_side"

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/social_network.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/entity/social_network.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/social_network.json",
  "@type": "SocialNetwork",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Social Network Entity Schema",
  "description": "v3 schema for social networking platforms where the primary value source is user-generated content and graph interactions among participants.",
  "examples": [
    {
      "description": "General social platform with feeds, groups, and creator communities",
      "reference": "social_network_example_general"
    },
    {
      "description": "Professional network with connection graph and community channels",
      "reference": "social_network_example_professional"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/digital_entity.json"
    },
    {
      "$ref": "../archetypes/network_graph.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "SocialNetwork"
    },
    "ontologicalMode": {
      "const": "DigitalEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "NetworkGraph"
      },
      "items": {
        "type": "string",
        "enum": [
          "NetworkGraph"
        ]
      }
    },
    "domain": {
      "const": "Social"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Advertising",
          "Subscription",
          "Freemium",
          "CreatorRevenueShare"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "WebApp",
          "MobileApp",
          "API"
        ]
      }
    },
    "name": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "description": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "shortDescription": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedTextOrString"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "foundingDate": {
      "type": "string",
      "format": "date"
    },
    "properties": {
      "type": "object",
      "properties": {
        "connectionModel": {
          "type": "string",
          "enum": [
            "follow",
            "friend_graph",
            "hybrid"
          ]
        },
        "feedRankingModel": {
          "type": "string",
          "enum": [
            "chronological",
            "algorithmic",
            "hybrid"
          ]
        },
        "supportsCreatorMonetization": {
          "type": "boolean"
        },
        "supportsPrivateCommunities": {
          "type": "boolean"
        },
        "moderationModel": {
          "type": "string",
          "enum": [
            "community",
            "ai_assisted",
            "human",
            "hybrid"
          ]
        },
        "contactPoints": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/ContactPoint"
          }
        },
        "socialProfiles": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/SocialProfile"
          }
        },
        "identifiers": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/Identifier"
          }
        }
      }
    },
    "capabilities": {
      "type": "object",
      "required": [
        "interaction",
        "content",
        "community"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        },
        "community": {
          "$ref": "../components/capability_groups.json#/$defs/CommunityCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "identity": {
          "type": "object",
          "properties": {
            "verifiedProfilesEnabled": {
              "type": "boolean"
            },
            "reputationSignalsEnabled": {
              "type": "boolean"
            },
            "impersonationDetectionEnabled": {
              "type": "boolean"
            }
          }
        },
        "moderation": {
          "type": "object",
          "properties": {
            "contentModerationEnabled": {
              "type": "boolean"
            },
            "appealsWorkflowEnabled": {
              "type": "boolean"
            },
            "safetyEscalationEnabled": {
              "type": "boolean"
            }
          }
        },
        "distribution": {
          "type": "object",
          "properties": {
            "recommendationEngineEnabled": {
              "type": "boolean"
            },
            "notificationRoutingEnabled": {
              "type": "boolean"
            },
            "trendingSystemsEnabled": {
              "type": "boolean"
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "many_to_many"
        },
        "roles": {
          "const": [
            "user",
            "user"
          ]
        },
        "valueSource": {
          "const": "user_generated"
        },
        "transactionFlow": {
          "const": "peer_to_peer"
        },
        "networkEffects": {
          "const": "same_side"
        },
        "graphGrowthPattern": {
          "type": "string",
          "enum": [
            "invite_driven",
            "interest_driven",
            "algorithmic_hybrid"
          ]
        }
      }
    },
    "targetAudience": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "siteCapabilities": {
      "type": "object",
      "properties": {
        "supportedDevices": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "desktop",
              "mobile",
              "tablet"
            ]
          }
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "accessibilityFeatures": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "@type",
    "ontologicalMode",
    "interactionArchetype",
    "domain",
    "name",
    "description",
    "deliveryFormat",
    "capabilities",
    "structuralMetadata",
    "modules"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "SocialNetwork is modeled as DigitalEntity + NetworkGraph because user-user graph and user-generated interactions are the dominant value source.",
    "disambiguationNotes": "Different from publisher-first content platforms where audience remains mostly passive."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-SOCN-001: @type MUST equal \"SocialNetwork\"",
      "RULE-SOCN-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-SOCN-003: interactionArchetype MUST contain \"NetworkGraph\"",
      "RULE-SOCN-004: capabilities MUST include interaction, content, community",
      "RULE-SOCN-005: structuralMetadata.valueSource MUST equal \"user_generated\"",
      "RULE-SOCN-006: structuralMetadata.networkEffects MUST equal \"same_side\""
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/social_network_example_schema_v3.json

{
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://data.meta-aiml.org/v3.0.0/examples/social_network/orbitlink-social",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/social_network/orbitlink-social",
  "@type": "SocialNetwork",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Social Network Entity Example (OrbitLink Social)",
  "ontologicalMode": "DigitalEntity",
  "interactionArchetype": [
    "NetworkGraph"
  ],
  "domain": "Social",
  "businessModel": [
    "Advertising",
    "Subscription",
    "Freemium",
    "CreatorRevenueShare"
  ],
  "deliveryFormat": [
    "WebApp",
    "MobileApp",
    "API"
  ],
  "name": {
    "en": "OrbitLink Social",
    "es": "OrbitLink Social",
    "fr": "OrbitLink Social"
  },
  "description": {
    "en": "OrbitLink Social is a fictional social platform centered on user-generated communities, creator channels, and graph-based discovery where value grows through peer interaction density.",
    "es": "OrbitLink Social es una plataforma social ficticia centrada en comunidades generadas por usuarios, canales de creadores y descubrimiento basado en grafo social.",
    "fr": "OrbitLink Social est une plateforme sociale fictive axee sur les communautes utilisateurs, les canaux createurs et la decouverte basee sur le graphe relationnel."
  },
  "shortDescription": {
    "en": "Graph-native social platform for communities, creators, and peer-to-peer engagement.",
    "es": "Plataforma social nativa de grafo para comunidades, creadores e interaccion entre pares.",
    "fr": "Plateforme sociale orientee graphe pour communautes, createurs et engagement pair-a-pair."
  },
  "url": "https://orbitlink-social.example",
  "foundingDate": "2020-08-10",
  "createdDate": "2026-02-20T18:42:00Z",
  "lastModified": "2026-02-20T18:42:00Z",
  "examples": [
    {
      "scenario": "Rapid growth in creator-led topic communities",
      "note": "AI should interpret network effects as same-side and prioritize community moderation and discovery pathways."
    },
    {
      "scenario": "Safety incident escalation across large groups",
      "note": "AI should reason through moderation, appeals, and trust signals without exposing private user-level data."
    }
  ],
  "properties": {
    "connectionModel": "hybrid",
    "feedRankingModel": "hybrid",
    "supportsCreatorMonetization": true,
    "supportsPrivateCommunities": true,
    "moderationModel": "hybrid",
    "contactPoints": [
      {
        "contactType": "support",
        "telephone": "+1-646-555-0191",
        "email": "support@orbitlink-social.example",
        "url": "https://orbitlink-social.example/help",
        "areaServed": "global",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      },
      {
        "contactType": "technical",
        "telephone": "+1-646-555-0114",
        "email": "trust-safety@orbitlink-social.example",
        "url": "https://orbitlink-social.example/safety",
        "areaServed": "global",
        "availableLanguages": [
          "en"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "instagram",
        "url": "https://instagram.com/orbitlink_social",
        "username": "orbitlink_social"
      },
      {
        "platform": "youtube",
        "url": "https://youtube.com/@orbitlinksocial",
        "username": "orbitlinksocial"
      },
      {
        "platform": "tiktok",
        "url": "https://tiktok.com/@orbitlinksocial",
        "username": "orbitlinksocial"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://orbitlink-social.example"
      },
      {
        "type": "custom",
        "value": "SOCN-ORB-001"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "commenting",
        "socialGraph",
        "feed",
        "notifications",
        "matching"
      ],
      "interactionMethods": [
        "in_app_messaging",
        "chat",
        "online_form"
      ],
      "availableActions": [
        "follow_user",
        "join_group",
        "post_content",
        "send_message",
        "report_content"
      ],
      "hasMessaging": true,
      "hasComments": true,
      "hasRating": false,
      "hasReviews": false,
      "hasSocialGraph": true,
      "hasFeed": true,
      "hasNotifications": true,
      "hasMatching": true,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "public",
        "friends_only",
        "private",
        "semi_anonymous"
      ]
    },
    "content": {
      "features": [
        "publishing",
        "curation",
        "mediaHosting",
        "search",
        "categories",
        "tags",
        "archives"
      ],
      "contentTypes": [
        "post",
        "short_video",
        "image",
        "live_stream",
        "story"
      ],
      "contentFormats": [
        "text",
        "html",
        "mp4",
        "webp",
        "json"
      ],
      "contentAccess": [
        "public",
        "member"
      ],
      "editorialControl": false,
      "userGeneratedContent": true,
      "mediaHosting": true,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    },
    "community": {
      "features": [
        "groups",
        "channels",
        "communities",
        "discovery",
        "moderation",
        "membershipManagement",
        "groupEvents",
        "polls"
      ],
      "supportsGroups": true,
      "supportsChannels": true,
      "communitiesCount": 128000,
      "hasDiscovery": true,
      "hasModeration": true,
      "moderationModel": "ai_assisted_human",
      "hasMembershipManagement": true,
      "membershipTypes": [
        "open",
        "invite_only",
        "verified_creator"
      ],
      "supportsGroupEvents": true,
      "supportsPolls": true,
      "hasGovernance": true,
      "governanceModel": "centralized",
      "privacyLevels": [
        "public",
        "closed",
        "secret"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "refunds",
        "wallet",
        "subscriptionManagement"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet",
        "bank_transfer"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD",
        "EUR"
      ],
      "priceRange": "freemium",
      "commissionModel": "percentage",
      "commissionRate": 12,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    }
  },
  "modules": {
    "identity": {
      "verifiedProfilesEnabled": true,
      "reputationSignalsEnabled": true,
      "impersonationDetectionEnabled": true
    },
    "moderation": {
      "contentModerationEnabled": true,
      "appealsWorkflowEnabled": true,
      "safetyEscalationEnabled": true
    },
    "distribution": {
      "recommendationEngineEnabled": true,
      "notificationRoutingEnabled": true,
      "trendingSystemsEnabled": true
    }
  },
  "structuralMetadata": {
    "topology": "many_to_many",
    "roles": [
      "user",
      "user"
    ],
    "valueSource": "user_generated",
    "transactionFlow": "peer_to_peer",
    "networkEffects": "same_side",
    "graphGrowthPattern": "algorithmic_hybrid"
  },
  "targetAudience": [
    "creators",
    "communities",
    "students",
    "professionals"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "caption_support",
      "text_scaling"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T18:42:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "SocialNetwork is modeled as DigitalEntity plus NetworkGraph because user-to-user interactions and generated content are primary value drivers.",
    "disambiguationNotes": "This is not a publisher-first broadcast platform. Value formation depends on graph density, group participation, and same-side network effects.",
    "intendedUse": "Canonical filled reference for social network sites that need precise AI understanding of graph-centric interaction architecture."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-SNGF-001: @type MUST equal \"SocialNetwork\"",
      "RULE-SNGF-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-SNGF-003: interactionArchetype MUST contain exactly one value: \"NetworkGraph\"",
      "RULE-SNGF-004: capabilities MUST include interaction, content, and community groups",
      "RULE-SNGF-005: modules.moderation MUST define operational safety controls",
      "RULE-SNGF-006: structuralMetadata constants MUST align with NetworkGraph archetype",
      "RULE-SNGF-007: multilingual name, description, and shortDescription MUST stay language-aligned",
      "RULE-SNGF-008: examples MUST include scenario and note fields for downstream agent behavior"
    ]
  }
}

All entities DatingPlatform FileHosting