[HelpHub] [6.4] Social Icon Block

[femkreations]

Article: https://wordpress.org/documentation/article/social-icons/

Updates for 6.4

• add X. 54092
• add Threads Icon 52685

Reference

• Pls refer for the previous versions tasks here

General

• Make sure all screenshots are relevant to the latest version
• Make sure videos, if any, are up to date
• Add ALT tags for the images
• Make sure the headings are in sentence case
• Convert all reusable blocks to a ‘regular block’.
• Update the changelog at the end of the article

[github-actions]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

[github-actions]

Heads up @femkreations - the "block editor" label was applied to this issue.

[cgarofalo]

@femkreations Please assign me to this issue. Thanks.

[abhansnuk]

Thank you for volunteering @cgarofalo

[abhansnuk]

Hello @cgarofalo just checking in for how you are getting on with this update. Thanks so much.

[cgarofalo]

@abhansnuk I'm still working on it. I've got a massive markdown document, as well as taking new screenshots. There are also videos. I'm continuing to work on it today.

[cgarofalo]

@abhansnuk, here is the write-up in markdown:

Social Icons Block

Go back to the list of Blocks

The Social Icons block allows you to add icons linking to your social media profiles or sites. This helps to increase the visibility of your social media profiles and drive traffic to them.

[social_icons_block.png]
Alt Text: A screenshot of the social icons block filled with social icons.

How to add Social Icons block

1. The Social Icons block can be added to a page by clicking on the Block Inserter (+) icon button. This will open the block inserter pop-up window. Search for the Social Icons block and add it to the page or post.

You can also type /social-icons and hit enter in a new paragraph block to quickly insert a Social Icons block.

[add_social_icons_block.png]
Alt Text: A dialogue box showing the Social Icons block selected.

2. Once you add the Social Icons block, you will see the following placeholder where you can add social icons.

[add_social_icons.png]
Alt Text: Placeholder to add social media icons to the Social Icons block.

---

Detailed instructions on adding blocks

---

How to add social icons and links

1. Select the Social Icons block and click on the (+) icon at the rightmost corner to show the available social media platforms list.

[search_social_icons.png]
Alt Text: A dialogue box showing the list of social media platforms available.

3. If you do not find the platform you are looking for in the menu, type the platform's name into the search box.

[searchbox_social_icons.png]
Alt Text: A dialogue box showing a text box to search for an available platform.

5. Select the icon from the menu to add it to the Social Icons block.

6. Click on the icon within the block to show the URL or email input field (Mail icon).

[social_icons_url_input.png]
Alt Text: A dialogue box prompting a URL entry.

7. Add the URL for the social media profile in the input field and press Enter. If omitted, WordPress will automatically set the default protocol to https.

8. Repeat these steps for each social media profile you want to add.

Note: When adding a Mail icon, you only need to type the email address. WordPress will automatically create a link that will open a new email screen in an email client when clicked on.

Available social media icons

• WordPress
• 500px
• Amazon
• Bandcamp
• Behance
• Link
• CodePen
• DeviantArt
• Dribbble
• Dropbox
• Etsy
• Facebook
• RSS Feed
• Flickr
• Foursquare
• Goodreads
• Google
• GitHub
• Instagram
• Last.fm
• LinkedIn
• Mail
• Mastodon
• Meetup
• Medium
• Patreon
• Pinterest
• Pocket
• Reddit
• Skype
• Snapchat
• SoundCloud
• Spotify
• Telegram
• Threads
• TikTok
• Tumblr
• Twitch
• Twitter
• Vimeo
• VK
• WhatsApp
• X
• Yelp
• YouTube

Block toolbar

Each block has its own block-specific controls that allow you to manipulate the block right in the editor.

The Social Icons block has two toolbars. One is the parent toolbar that appears when you select the Social Icons block. The other toolbar appears when you click on the individual social icons in the block.

The block toolbar for the Social Icons block

The Social Icons block toolbar has five buttons:

[social_icons_toolbar.png]
Alt Text: Social Icons block parent toolbar.

Transform to

You can transform the Social Icons block into a Group or Columns. You can also transform the style of the Social Icons block. Three styles are available: Default, Logos only, and Pill Shape.

[social_icons_tranform_to.png]
Alt Text: A dialogue showing the "transform to" options and styles.

Drag Icon

[social_icon_toolbar_drag.png]
Alt Text: The Social Icons block parent toolbar with the drag icon outlined in red.

To drag and drop the block to a new location on the page template, click and hold the rectangle of dots, then drag to the new location. The blue separator line indicates where the block will be placed. Release the left mouse button when you find the new location to place the block.

Move handles

[social_icon_toolbar_move_handles.png]
Alt Text: The Social Icons block parent toolbar with the move icon outlined in red.

The up and down arrow icons can be used to move a block up and down on the page.

---

Get more information about moving a block within the editor.

---

Change items justification

[social_icon_toolbar_justification.png]
Alt Text: A dialogue box displaying the Social Icons Block justification options.

The change items justification tool lets you change the horizontal placement of the items inside the Social Icons block. There are four options to choose from:

• Justify items left will move the items towards the left side of the block.
• Justify items center will move the items towards the center of the block.
• Justify items right will move the items towards the right side of the block.
• Space between items will distribute all items across the block and automatically adjust the space between them.

Change alignment

[social_icon_toolbar_alignment.png]
Alt Text: A dialogue box displaying the Social Icons Block alignment options.

The change alignment tool allows you to change the alignment of the social icons in the block. Here are the options available:

• None
• Align left – Make the block left-aligned.
• Align center – Make the block alignment centered.
• Align right – Make the block align right.

Size

[social_icon_toolbar_size.png]
Alt Text: A dialogue box displaying the Social Icons Block size options.

You can change the size of the icons by choosing one of the four preset icon sizes:

• Small
• Normal
• Large
• Huge

More options

social_icons_sizes.mp4

[social_icons_sizes.mp4]

These controls allow you to copy, duplicate, and edit your block as HTML.

---

Read about these and other settings.

---

The block toolbar for the individual social icons

The toolbar that appears when you press on the individual icons has four buttons:

[social_icon_toolbar_individual_icon.png]
Alt Text: The block toolbar for the individual social icons within the Social Icons block.

Select Social Icons

[social_icon_toolbar_individual_icon_selected.png]
Alt Text: Select social icons block.

This will take you to the parent Social Icons block toolbar. You will have the option to drag, move, and change item justification and alignment.

Each social icon toolbar also has more options explained above.

[social_icon_toolbar_individual_icon_more_options]
Alt Text: More options for individual icons toolbar.

Block Settings

Every block has specific options in the editor sidebar besides those found in the block toolbar. If you do not see the sidebar, click the ‘sidebar’ icon.

[social_icons_block_settings.png]
Alt Text: Sidebar icon to display the block's options in the sidebar.

There are two different sets of Block settings for the Social Icons block.

• The settings for the whole block appear when selecting the Social Icons block.
• The icons' settings appear when you click on an individual social icon.

The block settings for the Social Icons block

When you select the Social Icons block, you will see the following settings in the sidebar.

[social_icons_sidebar_block_options.png]
Alt Text: Settings sidebar tab for the Social Icons block.

Layout settings

With Layout settings, you can add justification to the social icons within the Social Icons block.

• left (default)
• center
• right
• space-between – will take up to 100% width and place icons at an equal distance in between

You can also change the orientation of the social icons to horizontal or stack them vertically, one below the other, if you have multiple social icons within the Social Icons block.

Allow to wrap to multiple lines toggle button lets you display the social icons in multiple lines when needed.

Link settings

Open links in a new tab: Using the toggle switch, you control whether or not the linked profile will open in a new browser tab.

Show labels: Using this toggle switch, you can show or hide the labels for the social icons.

[social_icon_with_label.png]
Alt Text: Blue WordPress social icon with label
Caption: Sample social icon with label

Advanced settings

[social_icons_advanced_tab_with_css_class.png]
Alt Text: Advanced settings with the default Styles CSS classes added by WordPress based on the Styles chosen.

The HTML Anchor is a helpful tool for creating page jumps. If you toggle the block to its HTML view, you’ll see that the HTML Anchor input is added as a CSS ID to the heading tag. You can also see the CSS class in the block's HTML.

The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit.

Based on which style you choose for the Social Icons block in the Styles settings, WordPress automatically adds a CSS class to the Social Icons block in the Advanced settings panel under Additional CSS class(es).

Styles settings

[social_icons_sidebar_block_style_options.png]
Alt Text: Styles settings sidebar tab for the Social Icons block

The Styles settings allow you to change the style of the icons in the block. You can choose among three styles: Default, Logos only, and Pill shape. Hover over the Styles buttons to get a preview of the styles.

social_icons_styles.mp4

[social_icons_styles.mp4]

Color settings

Default icons have their respective brand colors. With the Color settings, you can change the background and foreground color for all icons in the block to match your website branding. Pick a color from the suggestions, or add a custom color using the color picker or by adding a color code.

[social_icons_color_styles_sidebar.png]
Alt Text: Social Icons Block Sidebar Styles tab displaying the color options.

Alpha filter

Clicking on the selected color allows you to set the alpha filter, which creates a certain level of color transparency.

[social_icons_alpha_filter.png]
Alt Text: Dialogue box showing the advanced color settings, including the alpha filter

social_icons_alpha_filter.mp4

[social_icons_alpha_filter.mp4]

Background color

Besides color settings for individual icons, it is possible to set the background color for the entire Social icons block.

[social_icons_background_color.mp4]

social_icons_background_color.mp4

---

See this guide for more information about changing colors.

---

Dimension settings

Dimension sliders control how groups of blocks are placed alongside one another by changing the values for padding, margin, and other dimensions. Click the settings icon to enter custom dimensions.

[social_icons_dimentions.png]
Alt Text: A sidebar showing the block's dimension controls.

---

Learn more about dimension controls.

---

The block settings for individual social icons

When you click on the individual social icons in the Social Icons block, you get a different set of Block settings in the sidebar.

Link label

In the Social Icon sidebar settings, you can add a Link label. The label helps screen reader users understand the context of the link.

Advanced

Link rel

A new customizable “rel” attribute for the Social Icons block addresses the need to claim ownership of your WordPress sites on social networks.

To achieve this, these social networks require users to set a link back to their URL with the rel="me" attribute. With this new setting, it is possible to configure the “rel” attribute for each social icon displayed on your WordPress site.

Aditional CSS classes

The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit.

---

Change log

Update 2023-11-15

• Updated all screenshots & their alt texts
• Added X and Threads to the list
• Updated videos
• Clarified instructions
• Fixed grammatical errors

[abhansnuk]

Thank you @cgarofalo for all your efforts on this, and replying to the general message on all tickets on the progress check. Winstina may also have some input on this task as trying to find her comments and join the two up - waiting to confirm if this is the one she has been working on too.

To other reviewers, please do not move this to done for now. I have messaged Winstina on Slack too so we can incorporate her work too.

[abhansnuk]

In the meantime, @cgarofalo do you have access to the HelpHub CMS itself?

[cgarofalo]

@abhansnuk I do not.