https://forem-admin.netlify.app/assets/js/43e68696.9e53800e.js

1"use strict";(self.webpackChunkforem_admin=self.webpackChunkforem_admin||[]).push([[5819],{3905:function(e,t,n){n.d(t,{Zo:function(){return p},kt:function(){return c}});var r=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach((function(t){a(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function s(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var l=r.createContext({}),m=function(e){var t=r.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},p=function(e){var t=m(e.components);return r.createElement(l.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},d=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,o=e.originalType,l=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),d=m(n),c=a,h=d["".concat(l,".").concat(c)]||d[c]||u[c]||o;return n?r.createElement(h,i(i({ref:t},p),{},{components:n})):r.createElement(h,i({ref:t},p))}));function c(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=n.length,i=new Array(o);i[0]=d;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var m=2;m<o;m++)i[m]=n[m];return r.createElement.apply(null,i)}return r.createElement.apply(null,n)}d.displayName="MDXCreateElement"},5256:function(e,t,n){n.r(t),n.d(t,{default:function(){return p},frontMatter:function(){return i},metadata:function(){return s},toc:function(){return l}});var r=n(7462),a=n(3366),o=(n(7294),n(3905)),i={description:"A high-level overview of the most important Forem features.",sidebar_position:0},s={unversionedId:"forem-basics/user-roles",id:"forem-basics/user-roles",isDocsHomePage:!1,title:"User Roles",description:"A high-level overview of the most important Forem features.",source:"@site/docs/forem-basics/user-roles.md",sourceDirName:"forem-basics",slug:"/forem-basics/user-roles",permalink:"/docs/forem-basics/user-roles",editUrl:"https://github.com/forem/admin-docs/edit/main/docs/forem-basics/user-roles.md",version:"current",sidebarPosition:0,frontMatter:{description:"A high-level overview of the most important Forem features.",sidebar_position:0},sidebar:"tutorialSidebar",previous:{title:"Posts",permalink:"/docs/forem-basics/posts"},next:{title:"Profile Settings",permalink:"/docs/forem-basics/user-settings/profile-settings"}},l=[{value:"Base Roles",id:"base-roles",children:[{value:"Comment Suspend",id:"comment-suspend",children:[]},{value:"Suspend",id:"suspend",children:[]},{value:"Regular Member",id:"regular-member",children:[]},{value:"Trusted",id:"trusted",children:[]},{value:"Warn",id:"warn",children:[]}]},{value:"Special Roles",id:"special-roles",children:[{value:"Admin",id:"admin",children:[]},{value:"Resource Admin",id:"resource-admin",children:[]},{value:"Super Admin",id:"super-admin",children:[]}]}],m={toc:l};function p(e){var t=e.components,i=(0,a.Z)(e,["components"]);return(0,o.kt)("wrapper",(0,r.Z)({},m,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("div",{className:"admonition admonition-important alert alert--info"},(0,o.kt)("div",{parentName:"div",className:"admonition-heading"},(0,o.kt)("h5",{parentName:"div"},(0,o.kt)("span",{parentName:"h5",className:"admonition-icon"}

1,(0,o.kt)("svg",{parentName:"span",xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"},(0,o.kt)("path",{parentName:"svg",fillRule:"evenodd",d:"M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"}))),"important")),(0,o.kt)("div",{parentName:"div",className:"admonition-content"},(0,o.kt)("p",{parentName:"div"},"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 ",(0,o.kt)("a",{parentName:"p",href:"https://forem.dev"},"forem.dev")," to request additional support. We thank you for your patience and hope you're liking the changes!"))),(0,o.kt)("p",null,"A user's role indicates the level of permissions they have across the site."),(0,o.kt)("p",null,"To update a user's role, you'll need to:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Find them via ",(0,o.kt)("inlineCode",{parentName:"li"},"/admin/users")),(0,o.kt)("li",{parentName:"ul"},"Click the ",(0,o.kt)("inlineCode",{parentName:"li"},"Manage User")," button"),(0,o.kt)("li",{parentName:"ul"},"Select their new role","(","s) in the drop-down")),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"This is the page available at /admin/users",src:n(534).Z})),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"This is the page to manage users",src:n(278).Z})),(0,o.kt)("p",null,"Admins have the ability to remove any role other than the ",(0,o.kt)("strong",{parentName:"p"},"Super Admin")," role from users. Admins do not, however, have the ability to remove roles from themselves. To remove a user's role, you'll need to:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Find them via ",(0,o.kt)("inlineCode",{parentName:"li"},"/admin/users")),(0,o.kt)("li",{parentName:"ul"},"Click the ",(0,o.kt)("inlineCode",{parentName:"li"},"Manage User")," button"),(0,o.kt)("li",{parentName:"ul"},"Click the ",(0,o.kt)("inlineCode",{parentName:"li"},"X")," button next to the role","(","s",")"," you wish to remove")),(0,o.kt)("p",null,(0,o.kt)("img",{alt:"This is where admins can remove roles from users other than themselves",src:n(9965).Z})),(0,o.kt)("h2",{id:"base-roles"},"Base Roles"),(0,o.kt)("h3",{id:"comment-suspend"},"Comment Suspend"),(0,o.kt)("p",null,"Users with the ",(0,o.kt)("strong",{parentName:"p"},"Comment suspend")," role are users that no longer have the privilege to comment on posts. This role is typically reserved for users who struggle to behave appropriately in the comments section."),(0,o.kt)("h3",{id:"suspend"},"Suspend"),(0,o.kt)("p",null,"Users with the ",(0,o.kt)("strong",{parentName:"p"},"Suspend")," role no longer have the privilege to publish posts or comments across the site. Typically, a user is suspended when they have broken the Code of Conduct or Terms of Use multiple times."),(0,o.kt)("h3",{id:"regular-member"},"Regular Member"),(0,o.kt)("p",null,"A regular member is a user ",(0,o.kt)("strong",{parentName:"p"},"in good standing"),". They have access to all basic privileges ","(","publishing posts, writing comments, etc",")"," but they do not have higher access such as community moderation or site administration."),(0,o.kt)("h3",{id:"trusted"},"Trusted"),(0,o.kt)("p",null,"Users with the ",(0,o.kt)("strong",{parentName:"p"},"Trusted")," role are community moderators. They have access to ",(0,o.kt)("inlineCode",{parentName:"p"},"/mod")," and see a moderate icon on every post."),(0,o.kt)("h3",{id:"warn"},"Warn"),(0,o.kt)("p",null,"Users with the ",(0,o.kt)("strong",{parentName:"p"},"Warn")," role are users that admins flag to one another because of their previous behavior across the site. These are typically users that have broken the Code of Conduct previously but are currently not suspended. We want to make sure their previous actions are taken into consideration if they break the Code of Conduct again."),(0,o.kt)("p",null,"Users with the ",(0,o.kt)("strong",{parentName:"p"},"Warn")," role have all the same privileges as ",(0,o.kt)("strong",{parentName:"p"},"Members in good standing"),". Setting a ",(0,o.kt)("strong",{parentName:"p"},"Trusted")," User\u2019s role to ",(0,o.kt)("strong",{parentName:"p"},"Warn")," will remove their ",(0,o.kt)("strong",{parentName:"p"},"Trusted")," privileges and return them to the same privileges as ",(0,o.kt)("strong",{parentName:"p"},"Members in good standing"),"."),(0,o.kt)("p",null,"Changing a user's status to the ",(0,o.kt)("strong",{parentName:"p"},"Warn")," role does not automatically send an email to the user (we generally advise that users are notified when their roles change, including if they become ",(0,o.kt)("strong",{parentName:"p"},"Warned"),")."),(0,o.kt)("h2",{id:"special-roles"},"Special Roles"),(0,o.kt)("h3",{id:"admin"},"Admin"),(0,o.kt)("p",null,(0,o.kt)("strong",{parentName:"p"},"Admins")," have access to all ",(0,o.kt)("inlineCode",{parentName:"p"},"/admin")," pages on the site but do not have the ability to make site configuration changes (i.e. ",(0,o.kt)("inlineCode",{parentName:"p"},"admin/customization/config"),"). We recommend limiting the number of people who have ",(0,o.kt)("strong",{parentName:"p"},"Admin")," permissions for your Forem; consider granting single resource admin privileges first, where possible."),(0,o.kt)("p",null,(0,o.kt)("strong",{parentName:"p"},"Admins")," can unpublish articles by appending ",(0,o.kt)("inlineCode",{parentName:"p"},"/edit")," to the end of an article URL and updating the article manually."),(0,o.kt)("h3",{id:"resource-admin"},"Resource Admin"),(0,o.kt)("p",null,(0,o.kt)("strong",{parentName:"p"},"Single Resource Admins")," have access to select ",(0,o.kt)("inlineCode",{parentName:"p"},"/admin")," pages. For example, ",(0,o.kt)("strong",{parentName:"p"},"Resource Admin: Articles")," gives access to ",(0,o.kt)("inlineCode",{parentName:"p"},"/admin/content_manager/articles")," only. You can give someone as many ",(0,o.kt)("strong",{parentName:"p"},"Single Resource Admin")," roles as necessary, and we would always re

1commend granting these before a full ",(0,o.kt)("strong",{parentName:"p"},"Admin")," role."),(0,o.kt)("h3",{id:"super-admin"},"Super Admin"),(0,o.kt)("p",null,(0,o.kt)("strong",{parentName:"p"},"Super Admins")," have the highest level of permissions across the site, including making changes to ",(0,o.kt)("inlineCode",{parentName:"p"},"/admin/customization/config"),"."))}p.isMDXComponent=!0},9965:function(e,t,n){t.Z=n.p+"assets/images/userRolesCurrentRole-86001a88b3a0c4e65a6f0b17eaf3dba6.png"},534:function(e,t,n){t.Z=n.p+"assets/images/userRolesManage-0986c56dbbd406af5bd155fd36a00f91.png"},278:function(e,t,n){t.Z=n.p+"assets/images/userRolesNewStatus-18206602e0034c6ec0064b6e84ff7912.png"}}]);