Assign Transactions
Use the Assign Transactions window to quickly categorize uncategorized transactions and define keywords based on descriptions. This helps automate future imports and ensures consistent categorization.

How it works
These steps describe the dialog as it works on any Mac. macOS 26+ adds an optional AI Assist layer on top, covered at the end of this page.
(1) Select a transaction
Choose a transaction from the list to use as a reference. Its description will be used to define a keyword or search phrase.
If other transactions share the same description, they will appear as matches and will be reprocessed together once the category is assigned. The list is ordered by description.
Click any column header in the transactions list to sort by that column; click again to reverse the order. The sort order isn't saved between launches — the table always opens with its default sort.
(2) Edit the description
Refine the description to create a more specific or general keyword. This helps control how future transactions are matched.
If left empty, the category will be assigned only to the selected transaction.
- Reset — Restores the field to the original transaction description. Hidden when the keyword matches the description.
- Clear — Empties the keyword field entirely.
- Match counter — Below the keyword field, a green bar shows how many transactions match the current keyword, so you can gauge the impact before assigning. When the field is empty, it instead reminds you that only the selected transaction will be categorized.

Wildcard pattern
You can use the \*\ pattern in keywords to represent zero or more characters. This is useful when transaction descriptions share a common structure but vary in the middle — for example, reference numbers, dates, or check numbers.
Each segment between \*\ markers must appear in order within the transaction description. Wildcard keywords work both in the Assign dialog (match counter and batch assignment) and during transaction imports (auto-categorization). Examples:
PAYROLL\*\DEPOSIT— matches "PAYROLL 12345 DIRECT DEPOSIT", "PAYROLL ACH DEPOSIT", etc.CHECK\*\WITHDRAWAL— matches "CHECK #1042 WITHDRAWAL", "CHECK 5678 ATM WITHDRAWAL", etc.ARMAZONES\*\MARKETPLACE— matches "ARMAZONES.COM MARKETPLACE", "ARMAZONES BOOKS MARKETPLACE", etc.
Keyword warnings
On macOS 26 or later, two warnings help you avoid common keyword problems. They appear whenever the keyword changes, whether or not AI Assist is turned on.
Keyword mismatch — Appears when the keyword in the field doesn’t match the selected transaction’s description. This means the keyword won’t match the current transaction during future imports. You may want to reset the keyword or verify it’s intentional.

Broad keyword — Appears when the keyword is too generic and matches unrelated transactions. Expand the warning to see examples of other transaction descriptions that would also match. If Keyword Assist is turned on, the AI will automatically attempt to refine broad keywords, but you can also edit the keyword manually to make it more specific.

Here's another example of a broad keyword warning for "ARMAZONES":

(3) Pick a category
Choose the most appropriate category for the transaction. Only subcategories (categories without children) can be selected. The categories presented will match the transaction amount signal, with positive for income and negative for expenses.
- Search — Type in the search field to filter categories by name.
- Show inactive — Toggle to include inactive categories in the list. If you assign to an inactive category, it will automatically be activated.
- Clear — Empties the category search field.
(4) Assign
Click Assign to apply the selected category. The button is only enabled when both a transaction and a category are selected. If you entered a keyword in step 2, it will be saved and used to auto-categorize future transactions with matching descriptions.
All matched transactions will be categorized and removed from the list. A counter below the button tracks how many transactions have been assigned (e.g., "3/8 assigned").
Add Category (Optional)
Click Add Category... to create a new category if none of the current ones apply. You’ll be taken to the category editor.
Add Notes (Optional)
Use Add Notes... to attach a note to the assignment. The same note will be added to all matched transactions.
Add Image (Optional)
Click Add Image... to attach a receipt or supporting image. Only one image can be added per transaction. This image will be applied to all matched transactions.
AI Assist (macOS 26+)
Everything above works on every Mac, with or without AI. On macOS 26 or later with Apple Intelligence enabled, you can turn on AI Assist — two toggles that use the on-device model to speed up categorization by suggesting keywords and categories for you. By default it runs entirely on your computer, so no internet access is needed. On macOS 27 or later you can optionally have it use Private Cloud Compute for better suggestions.
AI Assist requires Apple Intelligence to be enabled on your Mac. The toggles are visible on all macOS versions but will be disabled if the on-device model is not available. On macOS 27 or later, the status pill tells you why. This feature will improve as Apple Intelligence improves.
Keyword Assist
When enabled, the AI analyzes the selected transaction’s description and suggests a shorter, more generic keyword. This is useful when descriptions contain unique reference numbers or dates that would prevent matching with similar transactions.
The suggested keyword appears in the description field with a typing animation. You can accept it, edit it further, or click Reset to restore the original description.
Category Assist
When enabled, the AI suggests a category based on the current keyword (or the transaction description if the keyword field is empty). The suggestion appears in the category search field, filtering the category list to help you find the right match.
You can accept the suggestion by selecting the category from the filtered list, clear it and type your own search, or turn off the toggle to clear the field.
Suggestion indicators
When AI Assist is enabled, two indicators show how its suggestions are going:
| Appearance | What it means |
|---|---|
![]() |
Confidence indicator — A small dot beside the keyword and category fields shows how confident the AI is in its suggestion: green for a good match, yellow for uncertain (review before accepting), and gray when there’s no suggestion yet. An amber alert dot means the AI couldn’t process the transaction — click it to read why. When the matching Assist toggle is off, the dot is a blank placeholder. |
![]() |
AI couldn’t suggest — When the AI can’t process a transaction, the amber dot becomes a button and opens a short popover — automatically the first time, then whenever you click the dot. The keyword field falls back to the full description, and you pick the category manually. |
Private Cloud Compute (macOS 27+)
Keyword and Category Assist normally use the Apple Intelligence model on your Mac. For better suggestions — especially for categories, obscure merchants, and descriptions with account or reference numbers — you can let them use Apple's larger Apple Intelligence model, which runs on Apple servers through Private Cloud Compute. Turn it on in Settings > Preferences > Transactions. It's off by default.
- What's sent — Only the transaction description and your category names. Amounts, dates, and accounts are never sent, and Apple doesn't keep the data.
- Internet connection — Private Cloud Compute needs one. When you're offline, Assist uses your Mac instead, so you still get a suggestion.
- Daily limit — Apple sets a daily usage limit, which is higher with most iCloud+ plans. When you reach it, Assist uses your Mac until the limit resets.
Learn more on Apple's pages: Apple Intelligence & Privacy and Learn about Apple Intelligence usage limits.
Assist status (macOS 27+)
A small pill at the top right of step (1) shows where Assist's suggestions come from — your Mac or Private Cloud Compute. It appears while Keyword or Category Assist is on, and always when Apple Intelligence can't run Assist, since the disabled toggles alone don't say why. Click it to see the details in a popover.

The pill takes one of these forms:

| Pill | What it means | The popover says |
|---|---|---|
| No Apple Intelligence (gray) | Your Mac doesn't support Apple Intelligence. Keyword and Category Assist aren't available. | This Mac doesn't support Apple Intelligence — You can still type keywords and pick categories yourself. |
| No Apple Intelligence (gray) | Apple Intelligence is still downloading or setting up — for example, right after you turn it on or after a macOS update. This clears on its own. | Apple Intelligence is getting ready — Reopen this window later to use Keyword and Category Assist. |
| No Apple Intelligence (orange) | Apple Intelligence is turned off on your Mac. | Apple Intelligence is off — Turn it on in System Settings > Apple Intelligence & Siri, then reopen this window. |
| Using this Mac | Assist runs on your Mac. Private Cloud Compute is off. | For better suggestions, turn on Private Cloud Compute in Settings > Preferences > Transactions. |
| Private Cloud Compute (green) | Assist uses Private Cloud Compute. | Private Cloud Compute is on. |
| Not ready, using this Mac | Private Cloud Compute isn't ready yet, so Assist uses your Mac for now. | Private Cloud Compute isn't ready yet. |
| Nearing today's limit (orange) | Assist still uses Private Cloud Compute, but you're close to today's limit. | You're nearing today's Private Cloud Compute limit. |
| Limit reached, using this Mac (red) | You've reached today's limit. Assist uses your Mac until it resets. | Assist uses this Mac until the reset time (for example, 9:00 PM), when Apple provides it. |
| Offline, using this Mac (orange) | The last suggestion couldn't reach Private Cloud Compute — usually no internet connection — so it came from your Mac. The next suggestion tries Private Cloud Compute again. | Check your internet connection. |
While Private Cloud Compute is on, the popover also reminds you that only the transaction description and your category names are sent, and where to turn it off.

