interactionStatistic
interactionStatistic · Optional
Appears in
What is it?
interactionStatistic records how many times people have interacted with an organization through a specific action type on a specific platform. It uses an InteractionCounter object that names the platform (as a SoftwareApplication or WebSite), specifies the interaction type (such as following or liking), and records the count. This field describes human-initiated interactions, as distinct from agentInteractionStatistic, which tracks AI agent actions.
Why this matters for AEO
AI answer engines use social proof and audience size signals when assessing organizational relevance and authority. An organization with 2 million LinkedIn followers occupies a different authority tier than one with 200 followers, and a structured interactionStatistic makes that distinction machine-readable. When an AI system responds to a query about influential companies in a sector, structured interaction counts provide a factual basis for ranking that is more reliable than inferring audience size from unstructured web text. This field is particularly useful for organizations where social presence is a credibility signal.
What the specs say
Schema.org:interactionStatistic expects an InteractionCounter object. The number of interactions for the CreativeWork using the WebSite or SoftwareApplication. The most specific child type of InteractionCounter should be used. The range includes CreativeWork, Organization, and Person. [Source: https://schema.org/interactionStatistic]
Google: Not mentioned in Google's structured data documentation for Organization. [Source: https://developers.google.com/search/docs/appearance/structured-data/organization]
How to find your value
Gather follower or interaction counts from your organization's public social profiles. Most platforms display these publicly on the profile page.
- LinkedIn — FollowAction
- Twitter / X — FollowAction
- Facebook — LikeAction
- YouTube — SubscribeAction
- Instagram — FollowAction
Use counts accurate to within the last 30 days. Stale counts reduce data quality but do not invalidate the markup.
Format and code
Each interactionStatistic is an InteractionCounter object with three key properties: interactionType (a schema.org action URL), interactionService (the platform as WebSite or SoftwareApplication), and userInteractionCount (the numeric count).
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "HubSpot",
"url": "https://hubspot.com",
"interactionStatistic": {
"@type": "InteractionCounter",
"interactionType": "https://schema.org/FollowAction",
"interactionService": {
"@type": "WebSite",
"name": "LinkedIn",
"url": "https://www.linkedin.com"
},
"userInteractionCount": 1800000
}
}
Multiple platforms use an array:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Mailchimp",
"url": "https://mailchimp.com",
"interactionStatistic": [
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/FollowAction",
"interactionService": {
"@type": "WebSite",
"name": "LinkedIn",
"url": "https://www.linkedin.com"
},
"userInteractionCount": 620000
},
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/FollowAction",
"interactionService": {
"@type": "WebSite",
"name": "Twitter",
"url": "https://twitter.com"
},
"userInteractionCount": 289000
}
]
}
Common interactionType values:
https://schema.org/FollowAction— followers, subscribershttps://schema.org/LikeAction— likes, reactionshttps://schema.org/CommentAction— commentshttps://schema.org/ShareAction— shares
Webflow implementation
Static pages
Add the JSON-LD in Page Settings > Custom Code on your homepage or about page. Update follower counts periodically. For most organizations, quarterly updates are sufficient unless counts change rapidly.
CMS template pages
If your site includes a CMS-driven team or partner directory with social presence data, store follower counts as number fields and platform names as text fields, then output them in a JSON-LD embed.
In Schema HQ
The interactionStatistic field configures interactionstatistic as a nested object in the organization schema editor. enter the platform name, interaction type url, and count. for multiple platforms, schema hq handles the array structure. is supported
Real examples
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Slack",
"url": "https://slack.com",
"interactionStatistic": [
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/FollowAction",
"interactionService": {
"@type": "WebSite",
"name": "LinkedIn",
"url": "https://www.linkedin.com"
},
"userInteractionCount": 1100000
},
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/SubscribeAction",
"interactionService": {
"@type": "WebSite",
"name": "YouTube",
"url": "https://youtube.com"
},
"userInteractionCount": 47000
}
]
}
Related fields
FAQ
What is the difference between interactionStatistic and agentInteractionStatistic?
interactionStatistic records interactions initiated by human users (following, liking, commenting). agentInteractionStatistic records interactions completed by AI agents acting in a specific role on a platform. Both use InteractionCounter, but they count different actor types.
Do the counts need to be exact?
No. Rounded or approximate counts are acceptable. The value communicates scale and order of magnitude to parsers, not precision to individual units. Round to the nearest thousand for large counts.
Is interactionType required?
Yes. Without interactionType, the counter has no meaning. Always specify a schema.org action URL to identify what kind of interaction is being counted.