Skip to content

Social: Document guidelines and extensibility #70961

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Mamaduka merged 2 commits into from
Jul 30, 2025
Merged

Social: Document guidelines and extensibility #70961

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
79944b9
Social: Document guidelines and extensibility
Mamaduka Jul 29, 2025
1324a6a
Feedback
Mamaduka Jul 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions packages/block-library/src/social-link/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Social Icon block

The Social Icon is a foundational block that displays various icons linking to different social profiles or sites. Each social service is registered as a variation of this block.


## Adding new social icons

The core maintains certain standards for adding new social icons. To add a new variation to WordPress, it must be well-established and popular.

To evaluate if a social service should be added, contributors will consider the following factors:

* Is the service popular enough for core developers to have heard of it before? Is it "mainstream?"
* How long has the service been online?
* Does it have a Wikipedia article?
* Is there a plugin adding social icons in the repository that includes the services in question and has a considerable number of active installations?
* Is this social service frequently requested?


## Adding custom social icons

Starting from WordPress 6.9, it's possible to add custom social icons to your site. See: [#70261](https://github.com/WordPress/gutenberg/pull/70261).
Loading