Alpha — This app is in early alpha. Accounts and progress may be reset before beta. Please disregard any references to "beta" elsewhere on the site.
← Back to News

How the Queuing System Works

The priority layers behind every study session

March 1, 2026 · Waffuru Team

Every time you start a study session, Waffuru puts together a mix of review cards and new cards. The new card feed isn't random. It follows a strict priority system that gives you control over what you learn while still making smart default choices.

The Priority Layers

New cards are drawn from four sources, checked in this order:

  • User-created cards: any custom cards you've made yourself always come first
  • Search queue: cards you've manually added from dictionary search results
  • Collections queue: cards from collections you've subscribed to, processed in sequence
  • Master deck: the full card database, ranked by your weighted frequency settings

The system exhausts each layer before moving to the next. If you've added 5 cards via search, those 5 appear before any collection cards. Once your search queue is empty, the next collection's cards start flowing in. When all subscribed collections are finished, the master deck takes over.

Reviews and Learning Cards

Due review cards are always included in your session and aren't affected by the new card priority system. Learning cards (ones you've seen recently but haven't graduated to the review stage) are interleaved throughout with priority over reviews, so you get short-interval repetitions when you need them.

Prerequisite Injection

When enabled in settings, Waffuru automatically inserts prerequisite cards before their dependents. If a word contains kanji you haven't studied, those kanji cards are injected first. If those kanji contain radicals you haven't studied, the radicals come first. You always have the building blocks before you see a complex card.

Put together, you get a session that respects your explicit choices first, follows your subscribed learning paths second, and fills remaining slots with the most useful vocabulary. And because of prerequisite injection, you'll have the background knowledge for every card you see.