Help / Developers /

Test mode

Updated 15 Nov 2026

Test mode gives each product a separate set of keys with its own requests, users and portal. Use it while you build and in CI: nothing reaches your live board, and nobody gets emailed.

Turn it on

Open any page of your product. At the top right there's a Live / Test switch; choose Test. The first time, List79 sets up test mode for the product. Everyone on your team except viewers can do this, and everyone can switch afterwards.

In test mode an orange banner shows at the top of every page, so you always know which side you're on. The switch keeps you on the same page, for example Keys in live mode and Keys in test mode. Request numbers are separate in each mode, so a request's page switches to the request list.

Test keys

Test mode has its own keys on its Keys and portal page:

  • a public key starting with pk_test_, for the widget;
  • its own widget secret, for signing user tokens;
  • secret API keys starting with sk_test_.

Put these in your development and staging setups, and the live keys in production. The widget, the API and the portal then work exactly as in live mode, but with test mode's own data.

What's different in test mode

  • No update emails. When you plan, ship or decline a request, nobody is emailed; the app reminds you that live mode would email the people who asked.
  • Not counted. Test users don't count toward your plan's active users, and test mode doesn't count as a product.
  • Its own portal. It's off until you switch it on. When it's on, it shows a "Test mode" banner and is hidden from search engines.
  • Its own webhooks. Endpoints you add in test mode get test mode's events only, marked "livemode": false.

The product's name is shared: renaming the product renames test mode too.

Start fresh

On test mode's Settings page (owners and admins):

  • Clear test data deletes test mode's requests, votes, comments, milestones and users. Its keys and settings keep working, so your development setup doesn't change.
  • Delete test mode removes it with its keys. Switch to Test again any time for a new set.

Deleting a product deletes its test mode too.