diff --git a/docs/assets/in-app-catalog-editor.png b/docs/assets/in-app-catalog-editor.png new file mode 100644 index 00000000..54498729 Binary files /dev/null and b/docs/assets/in-app-catalog-editor.png differ diff --git a/docs/guides/launch/feature-guide.mdx b/docs/guides/launch/feature-guide.mdx index b02705b4..8f5a67cf 100644 --- a/docs/guides/launch/feature-guide.mdx +++ b/docs/guides/launch/feature-guide.mdx @@ -24,6 +24,8 @@ Once your game is part of the program, it will be rotated in and out of featurin Once your game has been published and approved, it may be considered for the Featuring Program. You can also apply directly for consideration using the [Featuring Request Form](https://forms.gle/BeKcqQy8yZEqEmtR6). +If the In-app catalog editor is enabled for your app, you can also [upload and submit your catalog assets](./in-app-catalog-assets.md) in the Developer Portal so your game has the required visuals and metadata for discovery surfaces. + Please ensure you read this guide — especially the [requirements](#featuring-requirements) and [considerations](#featuring-considerations) — in its entirety before submitting your game. Games that see organic growth are also likely to be scouted by our team for featuring. @@ -94,4 +96,3 @@ Our goal is to feature games that feel great to play and reflect Reddit's creati Games that reach featured tiers often see thousands of daily players and dedicated community followings. When your game is featured, you'll receive promotional visibility through banners, feeds, and subreddit posts, as well as the opportunity to share your success across social channels and developer communities. See stories about successful games like [Honk](https://developers.reddit.com/docs/blog/honk) and [Syllocrostic](https://www.reddit.com/r/Devvit/comments/1n0vn97/reddit_has_acquired_syllacrostic/), which Reddit acquired after successful featuring. - diff --git a/docs/guides/launch/in-app-catalog-assets.md b/docs/guides/launch/in-app-catalog-assets.md new file mode 100644 index 00000000..c8b70700 --- /dev/null +++ b/docs/guides/launch/in-app-catalog-assets.md @@ -0,0 +1,53 @@ +# Manage in-app catalog assets + +In-app catalog assets help Reddit show your game in discovery surfaces such as the Games catalog and category-based game browsing. Use the **In-app catalog** section in the Developer Portal to upload your own game and promotional assets, configure where players should land, and submit the asset set for review. + +Approved assets do not replace your subreddit icon, banner, or colors. They are used for Reddit discovery and promotional placements where your app may appear. + +:::info +The In-app catalog editor is available for eligible game apps when this feature is enabled. If you do not see the section in Developer Settings, your app may not have access yet. +::: + +![In-app catalog editor preview and upload fields](../../assets/in-app-catalog-editor.png) + +The editor includes a live preview of your discovery assets and upload controls for each required media slot. + +## Open the editor + +1. Navigate to [Developer Portal](https://developers.reddit.com/). +2. Select your app. +3. Go to **Developer Settings**. +4. Find the **In-app catalog** section. + +You can also open the page directly at: + +```text +https://developers.reddit.com/apps/{your-app-slug}/developer-settings +``` + +## What you need + +All required fields must be complete before you can save changes. + +| Field | Required | Used for | +| --- | --- | --- | +| Game icon | Yes | The compact icon shown with your game. | +| Featuring asset | Yes | The large visual used in featured or promotional game units. | +| Fallback asset | Required only when the featuring asset is a video | The image or GIF shown when video cannot autoplay or is not supported. | +| Tile image | Yes | The smaller image used in game tiles. | +| Featuring description | Yes | Short text shown next to the featuring asset. | +| Tile tagline | Yes | Short text shown next to the game icon. | +| Game category | Yes | Helps category-based discovery and search. | +| Game subreddit | Yes | The subreddit where players should go to play or view posts. | +| Post sort order | No | Controls which posts are surfaced from the game subreddit. Defaults to **Hot**. | +| Post flairs | No | Helps narrow which posts may be surfaced. | + +## Tips for better assets + +- Make sure the first frame of a video communicates something meaningful in case autoplay is disabled. +- Avoid fast flashing, red strobe effects, and rapid full-screen color changes. +- Use enough contrast that logos and text remain readable in grayscale. +- Keep text inside images minimal; small game tiles may crop or scale the image. +- Prioritize polished, representative gameplay or game art over generic branding. + +For broader featuring guidance, see [Get featured](./feature-guide.mdx). diff --git a/sidebars.ts b/sidebars.ts index 6d18f15a..ee06cab8 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -106,9 +106,20 @@ const sidebars: SidebarsConfig = { label: "Launch Guide", }, { - type: "doc", - id: "guides/launch/feature-guide", + type: "category", label: "Feature Guide", + collapsed: false, + link: { + type: "doc", + id: "guides/launch/feature-guide", + }, + items: [ + { + type: "doc", + id: "guides/launch/in-app-catalog-assets", + label: "In-app Catalog Assets", + }, + ], }, { type: "link", diff --git a/versioned_docs/version-0.14/assets/in-app-catalog-editor.png b/versioned_docs/version-0.14/assets/in-app-catalog-editor.png new file mode 100644 index 00000000..54498729 Binary files /dev/null and b/versioned_docs/version-0.14/assets/in-app-catalog-editor.png differ diff --git a/versioned_docs/version-0.14/guides/launch/feature-guide.mdx b/versioned_docs/version-0.14/guides/launch/feature-guide.mdx index b02705b4..8f5a67cf 100644 --- a/versioned_docs/version-0.14/guides/launch/feature-guide.mdx +++ b/versioned_docs/version-0.14/guides/launch/feature-guide.mdx @@ -24,6 +24,8 @@ Once your game is part of the program, it will be rotated in and out of featurin Once your game has been published and approved, it may be considered for the Featuring Program. You can also apply directly for consideration using the [Featuring Request Form](https://forms.gle/BeKcqQy8yZEqEmtR6). +If the In-app catalog editor is enabled for your app, you can also [upload and submit your catalog assets](./in-app-catalog-assets.md) in the Developer Portal so your game has the required visuals and metadata for discovery surfaces. + Please ensure you read this guide — especially the [requirements](#featuring-requirements) and [considerations](#featuring-considerations) — in its entirety before submitting your game. Games that see organic growth are also likely to be scouted by our team for featuring. @@ -94,4 +96,3 @@ Our goal is to feature games that feel great to play and reflect Reddit's creati Games that reach featured tiers often see thousands of daily players and dedicated community followings. When your game is featured, you'll receive promotional visibility through banners, feeds, and subreddit posts, as well as the opportunity to share your success across social channels and developer communities. See stories about successful games like [Honk](https://developers.reddit.com/docs/blog/honk) and [Syllocrostic](https://www.reddit.com/r/Devvit/comments/1n0vn97/reddit_has_acquired_syllacrostic/), which Reddit acquired after successful featuring. - diff --git a/versioned_docs/version-0.14/guides/launch/in-app-catalog-assets.md b/versioned_docs/version-0.14/guides/launch/in-app-catalog-assets.md new file mode 100644 index 00000000..c8b70700 --- /dev/null +++ b/versioned_docs/version-0.14/guides/launch/in-app-catalog-assets.md @@ -0,0 +1,53 @@ +# Manage in-app catalog assets + +In-app catalog assets help Reddit show your game in discovery surfaces such as the Games catalog and category-based game browsing. Use the **In-app catalog** section in the Developer Portal to upload your own game and promotional assets, configure where players should land, and submit the asset set for review. + +Approved assets do not replace your subreddit icon, banner, or colors. They are used for Reddit discovery and promotional placements where your app may appear. + +:::info +The In-app catalog editor is available for eligible game apps when this feature is enabled. If you do not see the section in Developer Settings, your app may not have access yet. +::: + +![In-app catalog editor preview and upload fields](../../assets/in-app-catalog-editor.png) + +The editor includes a live preview of your discovery assets and upload controls for each required media slot. + +## Open the editor + +1. Navigate to [Developer Portal](https://developers.reddit.com/). +2. Select your app. +3. Go to **Developer Settings**. +4. Find the **In-app catalog** section. + +You can also open the page directly at: + +```text +https://developers.reddit.com/apps/{your-app-slug}/developer-settings +``` + +## What you need + +All required fields must be complete before you can save changes. + +| Field | Required | Used for | +| --- | --- | --- | +| Game icon | Yes | The compact icon shown with your game. | +| Featuring asset | Yes | The large visual used in featured or promotional game units. | +| Fallback asset | Required only when the featuring asset is a video | The image or GIF shown when video cannot autoplay or is not supported. | +| Tile image | Yes | The smaller image used in game tiles. | +| Featuring description | Yes | Short text shown next to the featuring asset. | +| Tile tagline | Yes | Short text shown next to the game icon. | +| Game category | Yes | Helps category-based discovery and search. | +| Game subreddit | Yes | The subreddit where players should go to play or view posts. | +| Post sort order | No | Controls which posts are surfaced from the game subreddit. Defaults to **Hot**. | +| Post flairs | No | Helps narrow which posts may be surfaced. | + +## Tips for better assets + +- Make sure the first frame of a video communicates something meaningful in case autoplay is disabled. +- Avoid fast flashing, red strobe effects, and rapid full-screen color changes. +- Use enough contrast that logos and text remain readable in grayscale. +- Keep text inside images minimal; small game tiles may crop or scale the image. +- Prioritize polished, representative gameplay or game art over generic branding. + +For broader featuring guidance, see [Get featured](./feature-guide.mdx). diff --git a/versioned_sidebars/version-0.14-sidebars.json b/versioned_sidebars/version-0.14-sidebars.json index 2991d31f..1a0585d3 100644 --- a/versioned_sidebars/version-0.14-sidebars.json +++ b/versioned_sidebars/version-0.14-sidebars.json @@ -92,9 +92,20 @@ "label": "Launch Guide" }, { - "type": "doc", - "id": "guides/launch/feature-guide", - "label": "Feature Guide" + "type": "category", + "label": "Feature Guide", + "collapsed": false, + "link": { + "type": "doc", + "id": "guides/launch/feature-guide" + }, + "items": [ + { + "type": "doc", + "id": "guides/launch/in-app-catalog-assets", + "label": "In-app Catalog Assets" + } + ] }, { "type": "link",