Skip to main content

Social Icons

A row of social-profile links, pulled live from Theme Settings → Social (social_profiles). It has no fields of its own — the profiles and the global icon style are configured on the Social tab, so every Social Icons instance stays in sync. Available in Header and Footer.

Where the code lives

Type keysocial_icons
Fieldsnone (pulls social_profiles + social_style from Theme Settings → Social)
Rendered byunysonplus_render_social_icons() in inc/includes/header-builder.php

How it works

For each profile it emits an <a class="header-social-icon"> (opening in a new tab unless disabled), with the profile's picked icon or a name-matched Font Awesome brand glyph fallback (so a profile named "Facebook" / "Instagram" / "X" shows the right icon out of the box). The wrapping <div> carries the global style classes from the Social tab — shape (social-style-{shape}), hover FX (social-fx-{fx}), and optional brand colors (social-brand):

<div class="header-social-icons social-icons social-style-{shape}">
<a href="{url}" class="header-social-icon" target="_blank" rel="noopener noreferrer" aria-label="{name}" title="{name}">
<i class="fab fa-{brand}" aria-hidden="true"></i>
</a>
</div>

Example 1 — basic

Two profiles configured on the Social tab (Facebook, Instagram), default style.

array(
'element_type' => array( 'element' => 'social_icons', 'social_icons' => array() ),
'visibility' => array(),
'element_css_class' => '',
)
<div class="header-element header-element--social_icons">
<div class="header-social-icons social-icons social-style-bare">
<a href="https://facebook.com/acme" class="header-social-icon" target="_blank" rel="noopener noreferrer" aria-label="Facebook" title="Facebook"><i class="fab fa-facebook-f" aria-hidden="true"></i></a>
<a href="https://instagram.com/acme" class="header-social-icon" target="_blank" rel="noopener noreferrer" aria-label="Instagram" title="Instagram"><i class="fab fa-instagram" aria-hidden="true"></i></a>
</div>
</div>

Example 2 — with Hide On + CSS Class

Hide On: phones, CSS Class: top-social.

array(
'element_type' => array( 'element' => 'social_icons', 'social_icons' => array() ),
'visibility' => array( 'hide-xs' ),
'element_css_class' => 'top-social',
)
<div class="header-element header-element--social_icons hide-xs top-social">
<div class="header-social-icons social-icons social-style-bare"></div>
</div>
  • Theme Settings → Social — where the profiles + icon style live.
  • Overview — the shared wrapper, Hide On, CSS Class.