30 days free. No credit card. Full access from the moment you connect your site.

Start free trial

Update Social Profile URLs

seo/update-social-profiles sets the social accounts this site belongs to — Facebook, X, Instagram, LinkedIn, Pinterest, YouTube, Wikipedia, Mastodon and others.

Yoast publishes them as sameAs links in its schema.

At a glance

Abilityseo/update-social-profiles
ToolsetYoast SEO — toolset/yoast-seo
GroupYoast SEO › Settings
RequiresYoast SEO, active on the site
Capabilitymanage_options
SafetyWrites data
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Abilities Manager 0.0.34 and later

What sameAs is for

The sameAs array is how structured data says “this entity and that profile are the same thing”. It is the mechanism by which a search engine connects a site to the organisation’s presence elsewhere, and it is one of the inputs to a knowledge panel.

Which means accuracy matters more than completeness. A profile listed here that belongs to somebody else is a claim that they are the same entity, and that is a worse error than omitting a profile.

Abandoned accounts are the common version of that mistake: an account nobody has posted to in five years is still a claim about identity, and it is usually better removed.

These complete the entity set in seo/update-knowledge-graph. On their own they attach to nothing.

They are distinct from seo/update-social-defaults, which is about what gets shared when somebody posts a link — different feature, similar name.

Idempotent.

Input

NameTypeRequiredWhat it is
settingsobjectYesA map of setting key to new value. Keys outside this area are refused.

What comes back

NameTypeWhat it is
updatedarrayThe keys that changed.
settingsobjectThe area after the write.
successbooleanWhether the call completed.
messagestringA one-line summary of what happened, suitable for showing a human.
error_codestringPresent only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation.

Example

Ask your assistant:

Add our LinkedIn and Mastodon profiles.

It resolves to one call:

{
  "ability": "seo/update-social-profiles",
  "parameters": {
    "settings": { "linkedin_url": "https://www.linkedin.com/company/example" }
  }
}

Worth knowing

  • sameAs is an identity claim, not a link list. Accuracy beats completeness.
  • Abandoned accounts are worth removing.
  • These attach to the knowledge graph entity — without one they do nothing.
  • Not the same as the social sharing defaults.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading