--- schema_version: "1" id: cc438490008ad211f85ef6373f21a72f4ba5579c24d68d9821fc279d1176ef7b title: ModerationRule collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_moderationrule.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_moderationrule.htm source_site: developer.salesforce.com content_type: documentation content_hash: cad615d35507eb8a04423da65002645c91ac502480f56181189bade029b3132c description: Represents a rule used in your Experience Cloud site to moderate member-generated content. 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 site from spammers, bots, and offensive or inappropriate content. This type extends the Metadata metadata type and inherits its fullName field. --- # ModerationRule Represents a rule used in your Experience Cloud site to moderate member-generated content. 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 site from spammers, bots, and offensive or inappropriate content. This type extends the Metadata metadata type and inherits its fullName field. ![Important](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note_important.png) #### Important Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations. Moderation rules created with the Metadata API are more powerful than moderation rules set up in the Experience Management UI. For example, in the UI you could create a rule that moderates posts and comments. In the Metadata API you could create a rule that moderates only the Link Name of a Link feed type. Use the Metadata API to express complex moderation rules. ![Important](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note_important.png) #### Important Don’t update moderation rules you create using the Metadata API in the Experience Management UI. If you do, you overwrite relevant Metadata API fields or the fields are ignored. Keep the following things in mind when creating moderation rules: - Your org can have up to 30 rules. This limit is per org, not per site. This limit includes both content rules and rate rules. - Each rule can have up to three keyword criteria. - Rules that block content run first, followed by rules to review and approve content, then rules that replace content, and last by rules that flag content. If two or more rules perform the same action, the oldest rule runs first, based on the date the rule was created. Rules to replace content don’t run when the content also applies to a review rule—we want community managers to review the original content. ## File Suffix and Directory Location ModerationRule components have the suffix .rule and are stored in the moderation directory of the corresponding package directory. The file name format follows site\_name.moderation\_rule\_developer\_name.rule. ## Version ModerationRule components are available in API version 36.0 and later. ## Special Access Rules To view, create, edit, and delete moderation rules, you need the Manage Experiences or Create and Set Up Experiences permission. As of Spring ’20 and later, only users with permission to edit moderation rules can access this object. ## Fields

Field Name	Field Type	Description
action	ModerationRuleAction (enumeration of type string)	Required. Indicates the moderation action that you want to take. The valid values are: `Block` `Review` `Replace` `Flag` `FreezeAndNotify` (Reserved for future use.)
actionLimit	int	Indicates the moderation action limit. Available in API 39.0 and later.
active	boolean	Required. Indicates whether the moderation rule is active (`true`) or inactive (`false`).
description	string	A description of the moderation rule.
entitiesAndFields	ModerateEntityField[]	Indicates the types of user-generated content this moderation rule applies to.
masterLabel	string	Required. Label for the moderation rule.
notifyLimit	int	Indicates the notification limit of the moderation rule. Available in API 39.0 and later.
userCriteria	string	Represents the member criteria to use in moderation rules. Available in API 39.0 and later.
userMessage	string	The message you want your 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 site. Review your content and try again.”

## ModeratedEntityField The fields and entities you want to moderate.

Field Name	Field Type	Description
entityName	string	Required. Indicates the types of user-generated content the moderation rule applies to. Post and comments only apply to content created in groups and user profiles. All feed types, such as polls and links, are supported.
fieldName	string	Indicates the field the moderation rule applies to. Note To moderate feed posts, use entityName `FeedItem` with fieldName `RawBody`. To moderate feed comments, use entityName `FeedComment` with fieldName `RawCommentBody`. The `RawBody` and `RawCommentBody` fields aren’t available in any other API.
keywordList	KeywordList string	Indicates the keyword list that you want to moderate against.

## ModerationRuleType Required. Indicates the type of rule to run on user-generated content.

Field Name	Field Type	Description
type	(enumeration of type string)	Required. Indicates the type of rule to run on user-generated content. Valid values are: Content Rate Available in API 39.0 and later.

## RateLimitTimePeriod Required. Indicates the time period that is applied to the rate limit.

Field Name	Field Type	Description
timePeriod	(enumeration of type string)	Required. Indicates the time period that is applied to the rate limit. Valid values are: Short Medium Available in API 39.0 and later.

## Declarative Metadata Sample Definition The following is an example of a ModerationRule component. Blocks Bad Word List in posts, comments, Link URLs, titles, and poll choices. Blocking Rule Block true You can't use %BLOCKED\_KEYWORD% or other inappropriate words in this site. Review your content and try again. FeedComment RawCommentBody site1.badword\_list FeedItem LinkUrl site1.badword\_list FeedItem RawBody site1.badword\_list FeedItem Title site1.badword\_list FeedPollChoice ChoiceBody site1.badword\_list The following is an example package.xml that references the previous definition. ModerationRule site1.blocking\_rule 36.0 ## Wildcard Support in the Manifest File This metadata type supports the wildcard character \* (asterisk) in the package.xml manifest file. For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/file_based_zip_file.htm "The deploy() and retrieve() calls are used to deploy and retrieve a .zip file. Within the .zip file is a project manifest (package.xml) that lists what to retrieve or deploy, and one or more XML components that are organized into folders.").

Note