Tags
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!
Tags are added to posts by authors and are used to categorize the post. Users can also follow tags which effect how often they are seen in the user's feed. Users can edit the follow weight of each tag from /dashboard/following_tags so that they see the tags more or less often.
Editing a tag#
As an admin, you have the ability to manipulate a number of traits for an individual tag by searching and clicking into the tag from /admin/content_manager/tags. After clicking on a tag name, you will be dropped into the /admin/content_manager/tags/{tag-id}/edit page and see the following options:
Moderators: add a user ID to add a tag moderator
Supported: checking this box will make the tag searchable to authors who are writing posts or listings. Note: adding a tag mod to a tag will automatically make it supported.
Badge: a square image that will appear at the top of the tag's landing page.
Category: (needs documentation)
Alias for: typing in a tag name here will make it so that any time a person uses this tag (the one you are editing) it will lead to the tag it is an alias for. (e.g. if "js" is an alias for "javascript" then anytime someone uses the tag "js" in their post, it will be replaced by "javascript"
Pretty Name: Shown at the top of the tag page
Short Summary: Displayed on tag page
Rules Markdown: Displayed on tag page + in drop-down of rich editor. Filling out this field adds a "Create Post" button to the tag page, taking users straight to a new post in their Post Editor with this tag prefilled.
Submission Template: This is where you create a post template! Place text here that will appear when you create any new posts under this tag. You can share these templates by directing people to /new/{tag_name}. This is especially useful when encouraging members to post about a topic in a structured format. This field takes markdown.
Here's an example of the template used for dev.to/new/shecoded:
Note that the template will also be accessible from the tag landing page by clicking on "write post" in the submission guidelines. The submission guidelines must be set for this to appear.
Wiki Body Markdown: Displayed on tag page
BG + Text color hex: Used as tag colors, ensure contrast meets a11y requirements