Skip to main content


These are guidelines that all themes are expected to abide by. Any themes that violates these will not be added to the BetterDiscord website or marked as official or approved in any fashion. Existing themes that push updates that violate these guidelines will have their updates denied.

General Guidelines

  1. Addons must be in public GitHub repositories.
  2. Addons must not negatively affect users.
    • e.g., ban risk, disabling security features, accessing private information
  3. Addons must not discriminate whom can use it.
  4. Addons must not collect user data without opt-in consent.
  5. Addons must not include explicit sexual material or other adult content.


  1. Do not degrade the user experience by removing core functionality.
    • e.g. hiding potentially important actions, unreadable text contrast, use of harmful animations, and flashing text.
  2. Do not target a specific user or group of users in a negative way (do not attempt to "ban" people).
  3. Do not encourage users to further violate Discord's Terms of Service, or promote content from outside of the official repository.
  4. Try to maintain support for Discord's accessability features.
  5. Maintain performance on modern hardware.
    • This can be done by limiting the use of intensive animations, filters and effects.


  1. Your theme's codebase must be made and written primarily by you.
    • You may not submit an automatically-generated theme, a customized version of someone else's theme, or a codebase written by someone other than you.
  2. Only import code from trusted services. (Github, Gitlab, Google Fonts, etc...)
  3. Do not abuse remote resources to gather user information, use untrusted content, or circumvent security permissions.
  4. You may reverse-engineer or use other people's code, provided you have proper permission and your theme's core design does not rely on third-party code.
  5. Minimize usage of language-specific selectors (e.g. aria-label attributes).
    • If used, provide sensible fallbacks for other languages.


  1. Themes should not be a basic recolor or background change. Themes should significantly alter the look and feel of Discord.
  2. Themes should have full coverage of most common pages, popouts, modals and controls. Keep in mind that changing Discord's variables does not provide full coverage of the app.