Tagging - Vanilla Success
<main> <article class="userContent"> <h2 data-id="overview">Overview</h2><p>Tagging is a feature that allows users to add keywords to discussions. For public communities, tags help label specific content for improved findability. When used with advanced search, they help isolate content by a relevant topic and improve results. </p><p>Tagging also has a module you can add to your theme, which can serve as site navigation.</p><p>Using the Tagging plugin also adds a couple of other benefits to your community:</p><ul><li>It can help with discovery of content because you and members of your community can see what content is creating discussions.</li><li>It improves SEO by making it easier for search engine robots to crawl community content</li><li>It adds a new dimension to Advanced Search, allowing searches by tags.</li></ul><p><br></p><h2 data-id="enabling-tagging">Enabling Tagging</h2><p>Tagging is not enabled by default for new communities, it will need to be toggled on by an administrator. </p><p>Tagging can be found in the Dashboard under the “Settings” tab, in the left-hand menu under the discussions heading. You can navigate to it directly by going to <code class="code codeInline" spellcheck="false" tabindex="0">/settings/tagging</code></p><h2 data-id="configuration">Configuration</h2><p>Once Tagging is enabled you will be presented with this page in your dashboard:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://images.v-cdn.net/docs/Tagging_Main.PNG" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://images.v-cdn.net/docs/Tagging_Main.PNG" alt="Tagging Menu"></img></a> </div> </div> <p><br></p><p>Here you can a view of all the tags that have been created and the number of times in which each tag has been used. </p><p>You may notice not all tags have the downward arrow to the right side -- this is because some tags are used for other functions in Vanilla and are non editable. Don't worry, you users will not be able to use these to tag discussions, these are infrastructure-only.</p><p>By clicking the downward arrow on the right side of each tag, you can:</p><ul><li>Add new tags, or see what tags have been already added.</li><li>See how many times a tag has been used.</li><li>Remove individual tags from your community by selecting delete. Only the tag will be removed, not the content.</li><li>Edit the text of a tag</li><li>Edit a tag’s URL slug</li></ul><p>Keeping tags and their URLs simple can be a great way to organize content and label it for search engines.</p><p>The tags in this list will be available for members of the community to select when they create a discussion or they can add their own on the front end (more on that in next section).</p><p>If you wish to see what content the tag is associated with, simply click on the tag.</p><h2 data-id="permissions">Permissions</h2><p>You may not want your entire user-base to have the ability to create unique tags. </p><p>Administrators can adjust this permission for individual roles:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://images.v-cdn.net/docs/Tagging_Permission.PNG" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://images.v-cdn.net/docs/Tagging_Permission.PNG" alt="Permissions for Tagging"></img></a> </div> </div> <p><br></p><p>Unchecking the “Add” permission will prevent those users from creating new tags <strong>but they will still be able to tag their posts with existing ones.</strong> </p><p>This allows administrators to restrict users to a curated pool of tags.</p><h2 data-id="using-tags">Using Tags</h2><p>Once tagging has been enabled, it adds a new field when a user is making a post:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://images.v-cdn.net/docs/Tagging_NewPost.PNG" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://images.v-cdn.net/docs/Tagging_NewPost.PNG" alt="Tagging Section In New Posts"></img></a> </div> </div> <p><br></p><p>When you begin to type a keyword into the field, a drop down display relevant tags to autocomplete with. Tags can be multiple words and are separated from one another by hitting the enter. </p><p>Clicking on the “Show Popular Tags” link allows users to see tags that people have used recently and choose from that list.</p><h2 data-id="how-many-tags-can-be-added-to-a-post">How many tags can be added to a post?</h2><p>By default, each post has a max of 5 tags that can be added. </p><p>If you'd like to increase or decrease this, contact your CSM or Vanilla Support.</p><h2 data-id="how-can-i-merge-tags">How can I merge tags?</h2><p>To merge tags, go to your Dashboard, then settings, then 'Tagging' in the left hand menu. </p><p>Once on this page, find the 'duplicate' tag you want to merge into another (for clarity let's call this the Primary tag). </p><p>Change the tag name and URL of the Duplicate Tag to the same thing as the Primary tag and hit save. </p><p>You will then see a pop up that looks something like this: </p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/6MPIQH6ZGH1P/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/6MPIQH6ZGH1P/image.png" alt="image.png"></img></a> </div> </div> <p>Simply click the 'Merge this tag with the existing one' box and hit save. </p><p>All posts that were tagged with the duplicate tag will now have the primary tag. </p><h2 data-id="additional-resources%3A">Additional Resources:</h2><ul><li>If you need to place the Tag module in you theme, check out our <a href="https://blog.vanillaforums.com/help/list-of-modules-for-your-themes/" rel="nofollow noreferrer ugc">Module List</a></li><li>Read more about Advanced Search, <a href="http://docs.vanillaforums.com/help/addons/advanced-search/" rel="nofollow noreferrer ugc">here.</a></li></ul><p><br></p> </article> </main>