Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/assets/in-app-catalog-editor.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion docs/guides/launch/feature-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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.

53 changes: 53 additions & 0 deletions docs/guides/launch/in-app-catalog-assets.md
Original file line number Diff line number Diff line change
@@ -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).
15 changes: 13 additions & 2 deletions sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion versioned_docs/version-0.14/guides/launch/feature-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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.

53 changes: 53 additions & 0 deletions versioned_docs/version-0.14/guides/launch/in-app-catalog-assets.md
Original file line number Diff line number Diff line change
@@ -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).
17 changes: 14 additions & 3 deletions versioned_sidebars/version-0.14-sidebars.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Loading