Added in 24.10.
Your community should be a positive space where members feel welcome, safe, and engaged. To foster this environment, moderators constantly monitor community activity by reviewing content for appropriateness based on the guidelines you’ve established.
You will learn about the permission, mutations, and queries for moderation in your community.
Members who have the Moderate content permission can perform moderation actions.
Note: Only Admins and Moderators can set the moderation settings at any level below the community level.
Set the moderation settings at any place in your community using the below fields:
Field | Sub-Field | Description | Required |
---|---|---|---|
nodeId | NA | The node ID where you want to set the moderation settings. | Required |
settingsInput | The moderation setting input to be set for the node. | Required | |
forumModerationStyle | Set the forum moderation style for the node. Supported values: PRE-MOD, POST-MOD, OFF |
Required | |
blogCommentModerationStyle | Set the blog comment moderation style for the node. Supported values: PRE-MOD, POST-MOD, OFF |
Required | |
tkbCommentModerationStyle | Set the KB comment moderation style for the node. Supported values: PRE-MOD, POST-MOD, OFF |
Required | |
occasionCommentModerationStyle | Set the occasion (Event) comment moderation style for the node. Supported values: PRE-MOD, POST-MOD, OFF |
Required | |
spamEnabled | To set the spam management for the node. Supported values: True or False |
Required | |
contentModerationEnabled | To set the content moderation for the node. Supported values: True or False |
Required |
Moderation Style
The moderation styles are:
PRE-MOD
- When a base user creates a post, it goes to the Moderation tab for approval from the moderator before becoming public.POST-MOD
- When a post is created by a base user, it becomes public but still goes to the Moderation tab for approval from the moderator.OFF
- The post becomes public and does not require moderator approval.
Example
To set the moderation settings, use the below GraphQL mutation:
mutation {
setModerationSettingsOnContainerNode(
nodeId:"community:titans2",
settingsInput: {
spamEnabled: true,
forumModerationStyle: PRE,
blogCommentModerationStyle: PRE,
tkbCommentModerationStyle: PRE,
ideaModerationStyle: PRE,
occasionCommentModerationStyle: PRE,
contentModerationEnabled: true
}) {
result
errors {
__typename
}
}
}
GraphQL response:
{
"data": {
"setModerationSettingsOnContainerNode": {
"result": true,
"errors": null
}
}
}
Set Moderation Settings for a Forum
Note: Only Admins and Moderators can set moderation settings.
Set the moderation settings for a forum using the below fields:
Field | Sub-Field | Description | Required |
---|---|---|---|
nodeId | NA | The forum board ID where you want to set the moderation settings. | Required |
settingsInput | The moderation setting input to be set for the node. | Required | |
forumModerationStyle | Set the forum moderation style for the node. Supported values: PRE-MOD, POST-MOD, OFF |
Required | |
spamEnabled | To set the spam management for the node. Supported values: True or False |
Required | |
contentModerationEnabled | To set the content moderation for the node. Supported values: True or False |
Required |
Example
mutation {
setModerationSettingsOnForumNode(nodeId:"board:forum1",
settingsInput:{
spamEnabled: false,
forumModerationStyle: PRE,
contentModerationEnabled: true
}){
result
errors{
__typename
}
}
}
GraphQL response:
{
"data": {
"setModerationSettingsOnForumNode": {
"result": true,
"errors": null
}
}
}
Set Moderation Settings for a Blog Board
Note: Only Admins and Moderators can set moderation settings.
Set the moderation settings for a blog board using the below fields:
Field | Sub-Field | Description | Required |
---|---|---|---|
nodeId | NA | The blog board ID where you want to set the moderation settings. | Required |
settingsInput | The moderation setting input to be set for the node. | Required | |
blogCommentModerationStyle | Set the blog comment moderation style for the node. Supported values: PRE-MOD, POST-MOD, OFF |
Required | |
spamEnabled | To set the spam management for the node. Supported values: True or False |
Required | |
contentModerationEnabled | To set the content moderation for the node. Supported values: True or False |
Required |
Example
mutation {
setModerationSettingsOnBlogNode(nodeId:"board:blog2",
settingsInput:{
spamEnabled: false,
blogCommentModerationStyle: PRE,
contentModerationEnabled: true
}){
result
errors{
__typename
}
}
}
GraphQL response:
{
"data": {
"setModerationSettingsOnBlogNode": {
"result": true,
"errors": null
}
}
}
Set Moderation Settings for a KB Board
Note: Only Admins and Moderators can set moderation settings.
Set the moderation settings for a KB board in your community using the below fields:
Field | Sub-Field | Description | Required |
---|---|---|---|
nodeId | NA | The KB board ID where you want to set the moderation settings. | Required |
settingsInput | The moderation setting input to be set for the node. | Required | |
tkbCommentModerationStyle | Set the KB comment moderation style for the node. Supported values: PRE-MOD, POST-MOD, OFF |
Required | |
spamEnabled | To set the spam management for the node. Supported values: True or False |
Required | |
contentModerationEnabled | To set the content moderation for the node. Supported values: True or False |
Required |
Example
mutation {
setModerationSettingsOnContainerNode(
nodeId:"community:titans2",
settingsInput: {
spamEnabled: true,
tkbCommentModerationStyle: PRE,
contentModerationEnabled: true
}) {
result
errors {
__typename
}
}
}
GraphQL response:
{
"data": {
"setModerationSettingsOnTkbNode": {
"result": true,
"errors": null
}
}
}
ATLAS
Comments