---
title: "Icons"
date: 2020-08-14
draft: false
description: "Icon support in Congo."
slug: "icons"
tags: ["icons", "sample", "shortcodes"]
---

Congo has built-in support for a number of [FontAwesome 5](https://fontawesome.com/icons) icons. These can be included in your website through either the [icon partial]({{< ref "docs/partials#icon" >}}) or [icon shortcode]({{< ref "docs/shortcodes#icon" >}}).

Additionally, custom icons are also fully supported. Simply provide your own SVG icon assets by placing them in the `assets/icons/` directory in the root of your project. Any icons in the icons directory will then be available to use throughout the theme.

The full list of built-in icons and their corresponding names can referenced below.

| Icon name            | Preview                           |
| -------------------- | --------------------------------- |
| amazon               | {{< icon amazon >}}               |
| apple                | {{< icon apple >}}                |
| blogger              | {{< icon blogger >}}              |
| codepen              | {{< icon codepen >}}              |
| dev                  | {{< icon dev >}}                  |
| dribbble             | {{< icon dribbble >}}             |
| edit                 | {{< icon edit >}}                 |
| email                | {{< icon email >}}                |
| exclamation-triangle | {{< icon exclamation-triangle >}} |
| facebook             | {{< icon facebook >}}             |
| flickr               | {{< icon flickr >}}               |
| foursquare           | {{< icon foursquare >}}           |
| github               | {{< icon github >}}               |
| gitlab               | {{< icon gitlab >}}               |
| google               | {{< icon google >}}               |
| instagram            | {{< icon instagram >}}            |
| keybase              | {{< icon keybase >}}              |
| kickstarter          | {{< icon kickstarter >}}          |
| lastfm               | {{< icon lastfm >}}               |
| link                 | {{< icon link >}}                 |
| linkedin             | {{< icon linkedin >}}             |
| mastodon             | {{< icon mastodon >}}             |
| medium               | {{< icon medium >}}               |
| microsoft            | {{< icon microsoft >}}            |
| moon                 | {{< icon moon >}}                 |
| orcid                | {{< icon orcid >}}                |
| patreon              | {{< icon patreon >}}              |
| pinterest            | {{< icon pinterest >}}            |
| reddit               | {{< icon reddit >}}               |
| researchgate         | {{< icon researchgate >}}         |
| slack                | {{< icon slack >}}                |
| snapchat             | {{< icon snapchat >}}             |
| soundcloud           | {{< icon soundcloud >}}           |
| stackoverflow        | {{< icon stackoverflow >}}        |
| steam                | {{< icon steam >}}                |
| sun                  | {{< icon sun >}}                  |
| telegram             | {{< icon telegram >}}             |
| tiktok               | {{< icon tiktok >}}               |
| tumblr               | {{< icon tumblr >}}               |
| twitch               | {{< icon twitch >}}               |
| twitter              | {{< icon twitter >}}              |
| whatsapp             | {{< icon whatsapp >}}             |
| youtube              | {{< icon youtube >}}              |