From a89efbd4b83e3beff8cf4996d3b7ea8e313fc966 Mon Sep 17 00:00:00 2001 From: Dikran Samarjian Date: Fri, 17 Apr 2026 18:07:02 -0700 Subject: [PATCH] separate requirements into devvit rules --- docs/capabilities/server/userActions.mdx | 34 +++++-------------- docs/devvit_rules.md | 23 +++++++++++++ .../capabilities/server/userActions.mdx | 34 +++++-------------- versioned_docs/version-0.12/devvit_rules.md | 23 +++++++++++++ 4 files changed, 62 insertions(+), 52 deletions(-) diff --git a/docs/capabilities/server/userActions.mdx b/docs/capabilities/server/userActions.mdx index 580e281..122893a 100644 --- a/docs/capabilities/server/userActions.mdx +++ b/docs/capabilities/server/userActions.mdx @@ -24,32 +24,14 @@ Some actions are not available to apps to prevent abuse and maintain platform in Requirements -------------- -To ensure a positive user experience and compliance with Reddit policies, your app must meet the requirements below. **Review can reject** apps until user action issues, including the game-specific items at the end, are resolved. - -- **When to post or comment as the user:** - - If users enter text or imagery that appears in your app, publish that content somewhere with reportable, actionable attribution, such as posts or comments submitted as the user. - - For score sharing, comments should be submitted as the user, not the app account. -- **Before you post or comment as the user:** - - Use an explicit manual action (for example, a button), users must clearly understand what will happen before they confirm. - - Make it clear they are posting or commenting as themselves, and what will appear on Reddit, including when their username is shown to others. - - Label buttons and flows so the action is obviously from the user's account, not only the app account. - - Do not automate these actions, and do not mislead or surprise users. -- **When posting or commenting as the user:** - - Set `userGeneratedContent` correctly for posts submitted on behalf of the user. - - For generic score comments, reply to a sticky comment. - - If the user adds meaningful commentary to their score, a top-level comment is allowed. - - Follow the detailed guidance in [Commenting scores](#commenting-scores). -- **Subscribe actions and gating:** - - Subscribing on behalf of the user must also be explicit and manual, with clear user understanding before confirmation. - - Do not require or encourage posting, commenting, or subscribing as a condition of progress, access, or core functionality. - - Do not merge gameplay actions with posting, commenting, or subscribing, each action must remain a separate, clear choice. See [End-of-game actions](#end-of-game-actions). -- **Remember the human:** - - Follow Reddit's safety and compliance guidelines for user-generated content. - - Do not create spam-like content or poor user experiences in pursuit of engagement. - -:::note -Apps using user actions must follow these requirements to be approved. -::: +To ensure a positive user experience and compliance with Reddit policies: + +- **Always ask permission:** Your app must always inform users before posting, commenting, or subscribing on their behalf. This can only happen on an explicit manual action, e.g. from a button. +- **No automated actions:** Users must explicitly opt-in to the app acting on their behalf. Do not mislead or surprise users. +- **Establish a reporting flow:** Ensure `userGeneratedContent` is correctly set for posts submitted on behalf of the user. +- **Do not gate any functionality:** Users should not be made or encouraged to post, comment, or subscribe to continue using your app. +- **Keep actions separate:** Do not merge posting, commenting, or subscribing with other app actions (e.g., gameplay progression). Each must remain a distinct, clear choice. +- **Remember the human:** Follow Reddit's safety and compliance guidelines for user-generated content. Do not create spam-like content or poor user experiences in pursuit of engagement. --- diff --git a/docs/devvit_rules.md b/docs/devvit_rules.md index d1f115d..b9064e0 100644 --- a/docs/devvit_rules.md +++ b/docs/devvit_rules.md @@ -150,6 +150,29 @@ Any content used or created by your Devvit app must comply with Reddit Terms & P If any content created or otherwise displayed through your app violates these Devvit Rules or other Reddit Terms & Policies, then Reddit may remove the content and/or request you remove the content. Failure to do so can result in your app being removed from Devvit. +### User action requirements + +If your app uses [user actions](./capabilities/server/userActions.mdx) (posting, commenting, or subscribing on behalf of the user), you must follow these requirements. Apps that do not meet them will be rejected during review. + +- **When to post or comment as the user:** + - If users enter text or imagery that appears in your app, publish that content with reportable, actionable attribution — such as posts or comments submitted as the user. + - For score sharing, comments must be submitted as the user, not the app account. + +- **Before you post or comment as the user:** + - Trigger the action only via an explicit manual action (for example, a button). Users must clearly understand what will happen before they confirm. + - Make it clear they are posting or commenting as themselves, including what will appear on Reddit and when their username is shown to others. + - Label buttons and flows so the action is obviously from the user's account, not only the app account. + - Do not automate these actions, and do not mislead or surprise users. + +- **When posting or commenting as the user:** + - Set `userGeneratedContent` correctly for posts submitted on behalf of the user. + - For generic score comments, reply to a sticky comment. If the user adds meaningful commentary to their score, a top-level comment is allowed. + +- **Subscribe actions and gating:** + - Subscribing on behalf of the user must also be explicit and manual, with clear user understanding before confirmation. + - Do not require or encourage posting, commenting, or subscribing as a condition of progress, access, or core functionality. + - Do not merge gameplay actions with posting, commenting, or subscribing — each action must remain a separate, clear choice. + ### Enable and respect user deletions Whether your app uses existing user content or otherwise allows users to create new user content, you and your app must always honor user deletion requests and respect redditors’ privacy rights. More specifically: diff --git a/versioned_docs/version-0.12/capabilities/server/userActions.mdx b/versioned_docs/version-0.12/capabilities/server/userActions.mdx index 580e281..122893a 100644 --- a/versioned_docs/version-0.12/capabilities/server/userActions.mdx +++ b/versioned_docs/version-0.12/capabilities/server/userActions.mdx @@ -24,32 +24,14 @@ Some actions are not available to apps to prevent abuse and maintain platform in Requirements -------------- -To ensure a positive user experience and compliance with Reddit policies, your app must meet the requirements below. **Review can reject** apps until user action issues, including the game-specific items at the end, are resolved. - -- **When to post or comment as the user:** - - If users enter text or imagery that appears in your app, publish that content somewhere with reportable, actionable attribution, such as posts or comments submitted as the user. - - For score sharing, comments should be submitted as the user, not the app account. -- **Before you post or comment as the user:** - - Use an explicit manual action (for example, a button), users must clearly understand what will happen before they confirm. - - Make it clear they are posting or commenting as themselves, and what will appear on Reddit, including when their username is shown to others. - - Label buttons and flows so the action is obviously from the user's account, not only the app account. - - Do not automate these actions, and do not mislead or surprise users. -- **When posting or commenting as the user:** - - Set `userGeneratedContent` correctly for posts submitted on behalf of the user. - - For generic score comments, reply to a sticky comment. - - If the user adds meaningful commentary to their score, a top-level comment is allowed. - - Follow the detailed guidance in [Commenting scores](#commenting-scores). -- **Subscribe actions and gating:** - - Subscribing on behalf of the user must also be explicit and manual, with clear user understanding before confirmation. - - Do not require or encourage posting, commenting, or subscribing as a condition of progress, access, or core functionality. - - Do not merge gameplay actions with posting, commenting, or subscribing, each action must remain a separate, clear choice. See [End-of-game actions](#end-of-game-actions). -- **Remember the human:** - - Follow Reddit's safety and compliance guidelines for user-generated content. - - Do not create spam-like content or poor user experiences in pursuit of engagement. - -:::note -Apps using user actions must follow these requirements to be approved. -::: +To ensure a positive user experience and compliance with Reddit policies: + +- **Always ask permission:** Your app must always inform users before posting, commenting, or subscribing on their behalf. This can only happen on an explicit manual action, e.g. from a button. +- **No automated actions:** Users must explicitly opt-in to the app acting on their behalf. Do not mislead or surprise users. +- **Establish a reporting flow:** Ensure `userGeneratedContent` is correctly set for posts submitted on behalf of the user. +- **Do not gate any functionality:** Users should not be made or encouraged to post, comment, or subscribe to continue using your app. +- **Keep actions separate:** Do not merge posting, commenting, or subscribing with other app actions (e.g., gameplay progression). Each must remain a distinct, clear choice. +- **Remember the human:** Follow Reddit's safety and compliance guidelines for user-generated content. Do not create spam-like content or poor user experiences in pursuit of engagement. --- diff --git a/versioned_docs/version-0.12/devvit_rules.md b/versioned_docs/version-0.12/devvit_rules.md index d1f115d..b9064e0 100644 --- a/versioned_docs/version-0.12/devvit_rules.md +++ b/versioned_docs/version-0.12/devvit_rules.md @@ -150,6 +150,29 @@ Any content used or created by your Devvit app must comply with Reddit Terms & P If any content created or otherwise displayed through your app violates these Devvit Rules or other Reddit Terms & Policies, then Reddit may remove the content and/or request you remove the content. Failure to do so can result in your app being removed from Devvit. +### User action requirements + +If your app uses [user actions](./capabilities/server/userActions.mdx) (posting, commenting, or subscribing on behalf of the user), you must follow these requirements. Apps that do not meet them will be rejected during review. + +- **When to post or comment as the user:** + - If users enter text or imagery that appears in your app, publish that content with reportable, actionable attribution — such as posts or comments submitted as the user. + - For score sharing, comments must be submitted as the user, not the app account. + +- **Before you post or comment as the user:** + - Trigger the action only via an explicit manual action (for example, a button). Users must clearly understand what will happen before they confirm. + - Make it clear they are posting or commenting as themselves, including what will appear on Reddit and when their username is shown to others. + - Label buttons and flows so the action is obviously from the user's account, not only the app account. + - Do not automate these actions, and do not mislead or surprise users. + +- **When posting or commenting as the user:** + - Set `userGeneratedContent` correctly for posts submitted on behalf of the user. + - For generic score comments, reply to a sticky comment. If the user adds meaningful commentary to their score, a top-level comment is allowed. + +- **Subscribe actions and gating:** + - Subscribing on behalf of the user must also be explicit and manual, with clear user understanding before confirmation. + - Do not require or encourage posting, commenting, or subscribing as a condition of progress, access, or core functionality. + - Do not merge gameplay actions with posting, commenting, or subscribing — each action must remain a separate, clear choice. + ### Enable and respect user deletions Whether your app uses existing user content or otherwise allows users to create new user content, you and your app must always honor user deletion requests and respect redditors’ privacy rights. More specifically: