Skip to content
Merged
Changes from 1 commit
Commits
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
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 social icons. To add a new one to the existing variations, it must be a well-established, popular, and mainstream service.

When considering establishment and popularity, several factors should be evaluated, such as:

* Is the service popular enough for core developers to have heard of it before? Is it "mainstream?"
* How old is the service?
* Does it have a well-established Wikipedia article? (Seriously.)
* Has anyone written a WordPress plugin that already adds it as a block variation? Do these plugins have any noticeable adoption or traction that would indicate usage and demand?
* 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. Here's an example plugin: https://github.com/wptrainingteam/devblog-custom-social-icons.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could include the dev block post when it's published.

Copy link
Contributor

@bph bph Jul 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For now I would link to the PR that makes it possible in Gutenberg. And once the dev blog post is published add it to the readme. Although the example plugin is certainly educational it only goes together with the Developer Blog post.

Loading