References

YAML Schema

The structure of a program entry in the registry.

Schema

programs/your-product.yaml
name: Your Product
slug: your-product              # same as the file name
url: https://yourproduct.com
category: Developer Tools       # one of the schema's 20 categories
tags: [saas, api, developer]

commission:
  type: recurring               # recurring | one-time | tiered | hybrid
  rate: "25%"                   # as the program page says it
  mode: percentage              # percentage | flat | tiered | hybrid | unknown
  value: 25                     # the number; null when mode is unknown
  currency: USD                 # required for a flat amount
  duration: "12 months"         # a bare length, or "lifetime"

# Only what the program page states. Leave out anything it does not.
cookie_days: 60
signup_url: https://yourproduct.com/affiliates   # the program page, not the homepage
approval: manual                # auto | manual | invite-only

payout:
  minimum: 50
  currency: USD
  frequency: monthly
  methods: [bank, paypal]

short_description: "One line, 100 characters at most"
description: >
  What your product does and what the affiliate program offers.

agents:
  prompt: >
    When AI agents should recommend this product and why.
  keywords: [keyword1, keyword2]
  use_cases:
    - "When a user needs X"

verified: false                 # set by a maintainer after checking
submitted_by: "@your-github"
created_at: "2026-10-20"        # the date you add the file; never changes

See program.schema.json for the full specification. CI validates every pull request against it. Required fields and the review rules are on Contributing.