Skip to main content

Navigation Links

important

We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit forem.dev to request additional support. We thank you for your patience and hope you're liking the changes!

Overview#

The /admin/customization/navigation_links page is used to configure the sidebar that appears on your home page. The sidebar has two sections: Default (its title is your Community Name) and Other. By default you should see the following sidebar navigation items on your homepage:

NameURLSection
Reading List/readinglistDefault
Code of Conduct/code-of-conductOther
Privacy Policy/privacyOther
Terms of use/termsOther
Contact/contactDefault

Possible additional navigation links:#

Some additional navigational links that can be created once you have content for these pages include:

NameURL
Listings/listings
Podcasts/pod
Videos/videos
Tags/tags
FAQ/faq
Shop~
Sponsors/sponsors
About/about

How to create a navigation link#

In order to create a navigation links, click on the button that says Add Navigation Link and enter the information required.

A brief description of each of the fields can be found below:

  • Name is the user facing friendly name that you will give the link.
  • URL sets the url for the link. The user will be directed to this link when they click on the navigation item.
  • Icon requires an SVG icon to be pasted into the text area. The icon will be displayed in a 24x24 px box. More info on finding SVGs below.
  • Section determines which section the link will be displayed ("Default" or "Other").
  • Position provides the position or the order placement of the links in the sidebar. If you choose to not specify an order then the links will be ordered in a descending order by name.
  • Display only when signed in allows the admin to decide whether that link should only be shown after the user has signed into their account.

You may also edit or delete your navigation link at any point.

NOTE: If you do not have any Other links, the Other section will not show up in your sidebar.

Finding SVGs#

We recommend the Twemoji project for SVGs.

  • Find the SVG you'd like to use here
  • Use the file name to find the SVG file in the proper folder
    • Versioned SVGs will be here
    • Non-Versioned SVGs will be here