Social Media Links
Manage your social media profile links centrally and display them anywhere in your theme with the Social Links widget.
TL;DR
Go to Admin → Social. Add your social media profiles (platform name + URL). The Social Links widget reads this list and displays icons and links in whatever widget area you assign it to.
Details
Managing Social Links
Each entry in the social links list has:
- Platform — the platform name (e.g.,
Twitter,GitHub,YouTube,LinkedIn,Instagram,Mastodon). This is used byIconServiceto determine which icon to display. - URL — the full profile URL (e.g.,
https://twitter.com/youraccount). - Sort Order — controls the display order. Drag-and-drop reordering is supported in the admin table.
- Active toggle — inactive links are not shown in the widget but are preserved in the database.
Add, edit, or delete links from Admin → Social. Changes are reflected immediately on the front end.
Icon Resolution
IconService automatically maps platform names to the correct icon class based on the active theme's declared icon_pack. With the default FontAwesome 6 pack:
| Platform | Icon Class |
|---|---|
| Twitter / X | fa-brands fa-x-twitter |
fa-brands fa-facebook | |
fa-brands fa-instagram | |
| YouTube | fa-brands fa-youtube |
| GitHub | fa-brands fa-github |
fa-brands fa-linkedin | |
| Mastodon | fa-brands fa-mastodon |
| RSS | fa-solid fa-rss |
Platforms not in the map fall back to fa-solid fa-link.
Social Links Widget
To display your social links on the front end, add the Social Links widget to any widget area (typically the header, sidebar, or footer) via Admin → Widgets.
Widget options:
| Option | Type | Default | Description |
|---|---|---|---|
| title | text | Follow Us | Widget heading (leave blank to hide) |
| style | select | icons | icons shows icon-only buttons; icons+text shows icon with platform label |
The widget only shows links with is_active = 1, ordered by sort_order.