On this page:
This is some text inside of a div block.
This is some text inside of a div block.
This is some text inside of a div block.

interactionStatistic

interactionStatistic · Optional

Appears in

Organization

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, subscribers
  • https://schema.org/LikeAction — likes, reactions
  • https://schema.org/CommentAction — comments
  • https://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.

On this page:
This is some text inside of a div block.
This is some text inside of a div block.
This is some text inside of a div block.
Generate schema for your site with Schema HQ

Get Early Access

Get Early Access

Need help with schema on your site?

We implement structured data for Webflow sites — from audit to deployment.

Work with us

Work with us