Start a conversation

Working with Moderation

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.

Moderator Permission
Moderator Permission
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
    }
  }
}
Choose files or drag and drop files
Was this article helpful?
Yes
No
  1. ATLAS

  2. Posted
  3. Updated

Comments