# Icon

Similar to the Emoji :shortcode: syntax, you can add icons using :icon-shortcode:, where the shortcode is an Octicon icon name.

For example, to add the star icon, use the :icon-star: icon shortcode.

Icons can be added anywhere within your document, including paragraph text, headings, table content, Panel component titles, Alerts, code block titles, etc.

Some icon shortcode names are made up of two-or-more words. For instance, the git-branch icon would be configured as :icon-git-branch:.