--- 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 >}} | | 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 >}} | | 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 >}} |