# Promote your daily game

> dledex (https://dledex.com) is a free directory of 3918 daily browser games like Wordle, each with a score from 0 to 10. Listing is free, every game is checked, and every game opens on its own site. This page is the Markdown version of https://dledex.com/creators.

## Where players find daily games

- **Directories of daily games.** dledex, The Dles, Playlin, Listdle and Alldle list daily games and take new ones. On dledex, the link is all it takes (below).
- **Reddit.** Communities about browser games, puzzles and your game's topic. Read each community's rules on self-promotion first: many welcome a post about a game you made, some only on set days or in a weekly thread.
- **Discord.** Servers about daily puzzles and about your game's topic; many have a channel for new games.
- **Your own players.** Wordle grew through its result grid. A share button that copies a spoiler-free result lets every player bring friends, every day.
- **Show HN and Product Hunt**, for an idea that is new.

## The day you share it

- Choose one day and post everywhere on that day, with a short clip or screenshot of a round.
- Post when your daily puzzle resets, so the first visitors get a fresh one.
- Stay for the comments that day: answers and fixes on day one bring players back on day two.

## List, verify and add the badge with plain HTTP

Every step is one request, so a script or an AI coding assistant can do it as well as a person. Spec: https://dledex.com/openapi.json.

1. Look the game up (listed, pending or not listed):

   ```sh
   curl "https://dledex.com/api/lookup?url=https://example.com/my-daily-game"
   ```

2. Not listed yet? Submit it. Free; the review finds the name, category and description on the page and usually adds a game within a few days:

   ```sh
   curl -X POST https://dledex.com/api/agent/submit -H "content-type: application/json" -d '{"url":"https://example.com/my-daily-game"}'
   ```

3. Verify the site, no account needed. Ask for the site's code:

   ```sh
   curl -X POST https://dledex.com/api/verify/start -H "content-type: application/json" -d '{"url":"https://example.com/my-daily-game"}'
   ```

   Put the returned tag in the `<head>` of the site's start page (or of the game's page):

   ```html
   <meta name="dledex-verification" content="dledex-site-…">
   ```

   or the code alone in `/.well-known/dledex.txt`. Then:

   ```sh
   curl -X POST https://dledex.com/api/verify/check -H "content-type: application/json" -d '{"url":"https://example.com/my-daily-game"}'
   ```

4. Recommended: the badge "Listed on dledex", keyed by the game's URL, so it can go on the site right away: it stays an invisible pixel until the game is listed, then shows the badge and links to the game's page. Once listed, `/api/lookup` also returns the per-game HTML (`badge.html`; other styles, with the live score, in `badge.styles`).

   ```html
   <a href="https://dledex.com/go?url=https%3A%2F%2Fyour-game.example%2F"><img src="https://dledex.com/badge.svg?url=https%3A%2F%2Fyour-game.example%2F&style=featured" alt="Listed on dledex" height="54"></a>
   ```

## What verification does

- Verified games take turns in the Spotlight above their categories' lists on dledex (drawn every day) and are drawn more often in "Surprise me".
- A creator who signs in and claims the game sees its ratings and plays and answers comments as the verified creator.

## Rules

- Listing, the review and the Spotlight never depend on a link or a badge on your site. The badge is voluntary, and nothing is given for it.
- Every game gets the same review: a free daily game that loads, not a duplicate. dledex doesn't sell placements.
- Limits: lookups and verification 20 requests a minute per IP; submissions 3 a minute per IP and 3 a day per site; a site can be checked once every 15 seconds.
