> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt ## Resource: Reviews Moderation Business Flow ## Article: Flow: Reviews and Moderation ## Article Link: https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews-moderation-business-flow.md ## Article Content: # Flow: Reviews and Moderation This article outlines the flow for moderating site visitor reviews using the [Reviews](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/introduction.md) and [Moderation Rules](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/moderation-rules/introduction.md) APIs. It covers creating reviews, setting up automated moderation, and handling flagged content. > **Note:** On Wix sites, you can manage and moderate reviews with the [Wix Reviews app](https://support.wix.com/en/article/wix-stores-adding-and-setting-up-wix-reviews). ## Before you begin It's important to note the following points before starting to code: - Reviews are only integrated with [Wix Stores](https://dev.wix.com/docs/api-reference/business-solutions/stores/introduction.md). Wix Stores must be installed on a site. - Products must exist in the store. See the [Products API](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/introduction.md) for more information. - Each review requires a contact ID. See the [Contacts API](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/contacts/introduction.md) for more information. ## Reviews and moderation flow The following diagram shows the full reviews and moderation flow. ![Reviews and Moderation Flow](https://wixmp-833713b177cebf373f611808.wixmp.com/images/77bac402437f6f0d8282281384736205.png) ### Step-by-step implementation The following steps describe the complete flow for creating reviews with automated moderation and handling reviews that require manual approval. ### Step 1 | Set up moderation rules Create moderation rules that define how reviews are evaluated after being submitted. Each rule pairs a trigger with an action. For example, to manually moderate reviews that include images, create a rule with `trigger.contentFeaturesOptions.images` set to `true` and `action.type` set to `NEEDS_MANUAL_APPROVAL`. **Action:** Call [Create Rule](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/moderation-rules/create-rule.md). **Result:** Moderation rule created. ### Step 2 | Create reviews Reviews are created when site visitors submit them through a form, or when you programmatically create them via the Reviews API. **Action:** Call [Create Review](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/create-review.md). To import or migrate multiple reviews, call [Bulk Create Review](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/bulk-create-review.md). **Result:** Review created with a moderation status of `SUBMITTED`. Continue to Step 3. ### Step 3 | Moderation evaluates review content **Action:** The system automatically checks the submitted review against active moderation rules: - If no rule is triggered, the `moderationStatus` of the review is updated to `APPROVED`. - If `action.type` is `REJECT`, the `moderationStatus` of the review is updated to `REJECTED`. - If `action.type` is `NEEDS_MANUAL_APPROVAL`, the `moderationStatus` of the review is updated to `IN_MODERATION`. **Possible results:** - Review is approved and published. Flow ends. - Review is rejected. Flow Ends. - Review requires manual evaluation. Continue to Step 4. ### Step 4 | Query reviews pending manual moderation Retrieve reviews that require manual moderation and evaluate their content. **Action:** Call [Query Reviews](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/query-reviews.md) with a filter for `moderation.moderationStatus` equal to `IN_MODERATION`. Use the returned review content for evaluation. **Result:** A list of reviews requiring manual evaluation. ### Step 5 | Update the moderation status For each review, evaluate its content, decide to approve or reject, and update its status accordingly. **Action:** For each review, call [Update Moderation Status](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/update-moderation-status.md) with `reviewId` set to that review's ID. To process multiple reviews at once, call [Bulk Update Moderation Status](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/bulk-update-moderation-status.md). **Possible Results:** - The review is approved and published. Flow ends. - The review is rejected. Flow ends. ## Results After implementing this flow, you have a review moderation system that automatically evaluates reviews against moderation rules and provides a workflow for manually evaluating flagged content. ## See also - [Reviews API Introduction](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/introduction.md). - [Moderation Rules API Introduction](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/moderation-rules/introduction.md).