Newer Version Available

This content describes an older version of this product. View Latest

ModerationRule

Represents a rule used in your community to moderate member-generated content. Available in Tooling API version 36.0 and later.

Each rule specifies the member-generated content the rule applies to, the criteria to enforce the rule on, and the moderation action to take. Moderation rules help protect your community from spammers, bots, and offensive or inappropriate content.

Supported SOAP Calls

create(), delete(), query(), retrieve(), update()

Supported REST HTTP Methods

DELETE, GET, PATCH, POST

Fields

Field Details
Action
Type
picklist
Properties
Defaulted on create, Filter, Group, Nillable, Restricted picklist
Description
Required. Indicates the moderation action that you want to take. The valid values are:
  • Block
  • Review
  • Replace
  • Flag
  • FreezeAndNotify (Reserved for future use.)
ActionLimit
Type
int
Properties
Filter, Group, Nillable, Sort
Description
Indicates the moderation action limit measured in minutes. Available in API version 39.0 and later.
Active
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Required. Indicates whether the moderation rule is active (true) or inactive (false).
Description
Type
textarea
Properties
Filter, Nillable, Sort
Description
A description of the moderation rule.
DeveloperName
Type
string
Properties
Filter, Group, Namefield, Sort
Description
The developer’s internal name for the moderation rule used in the API.
FullName
Type
string
Properties
Create, Group, Nillable
Description
The full name of the associated metadata object in Metadata API.
Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
Language
Type
picklist
Properties
Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort
Description
The language of the moderation rule. Valid values are:
  • Chinese (Simplified): zh_CN
  • Chinese (Traditional): zh_TW
  • Danish: da
  • Dutch: nl_NL
  • English: en_US
  • Finnish: fi
  • French: fr
  • German: de
  • Italian: it
  • Japanese: ja
  • Korean: ko
  • Norwegian: no
  • Portuguese (Brazil): pt_BR
  • Russian: ru
  • Spanish: es
  • Spanish (Mexico): es_MX Spanish (Mexico) defaults to Spanish for customer-defined translations.
  • Swedish: sv
  • Thai: th The Salesforce user interface is fully translated to Thai, but Help is in English.
MasterLabel
Type
string
Properties
Filter, Group, Sort
Description
Label for the moderation rule.
Metadata
Type
mns:ModerationRule
Properties
Create, Nillable, Update
Description
Moderation rule metadata. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
NotifyLimit
Type
int
Properties
Filter, Group, Nillable, Sort
Description
Indicates the notification limit (in seconds) of the moderation rule. Available in API version 39.0 and later.
TimePeriod
Type
RateLimitTimePeriod (enumeration of type string)
Properties
Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort
Description
The values that represent the time-frame for which a rate limiting rule is applied. The two values available represent a time periods measured in minutes: “Short” represents 3 minutes and “Medium” represents 15 minutes. Available in API version 39.0 and later. Valid values are:
  • Short
  • Medium
Type
Type
ModerationRuleType (enumeration of type string)
Properties
Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort
Description
Type of moderation rule. Content rules protect your community from offensive language and inappropriate content created by spammers or malicious members. Rate rules protect your community against spammers and bots that attack your community by posting the same message multiple times in a row. Available in API version 39.0 and later. Valid values are:
  • Content
  • Rate
UserMessage
Type
textarea
Properties
Filter, Nillable, Sort
Description
The message you want your community members to see when their content is blocked. Use the %BLOCKED_KEYWORD% variable to display up to five blocked words in the user message. If you don’t specify a message, the member sees the standard message: “You can’t use %BLOCKED_KEYWORD% or other inappropriate words in this community. Review your content and try again.”