--- title: "Creating Enrichments" description: "Build a rule that auto-fills fields like category on your synced bank data, preview it against real records, then apply it to a feed." section: "Enrichments" canonical: "https://banksync.io/docs/enrichments/creating-enrichments" --- Enrichments transform your bank data as it syncs, so the records that land in your connected sheet, database, or table are already cleaned up and categorized. A **Rule** enrichment (a ruleset) automatically sets a field value (like `category`) whenever a record matches the conditions you define. For example: when the description contains "UBER", set Category to "Transport". [![Creating an auto-categorize enrichment: the Enrichments tab grid, the New Enrichment type picker with Ruleset, Alert and Memory options, the rule editor where Uber Spending maps merchant contains UBER to the Transportation category and Coffee Shops to Dining, autosave confirming, and the new ruleset card on the grid.](https://cdn.banksync.io/videos/enrichment-auto-categorize.poster.f088c13517e9e620.png)](https://cdn.banksync.io/videos/enrichment-auto-categorize.7a48460397c10642.mp4) [Watch: Creating an auto-categorize enrichment: the Enrichments tab grid, the New Enrichment type picker with Ruleset, Alert and Memory options, the rule editor where Uber Spending maps merchant contains UBER to the Transportation category and Coffee Shops to Dining, autosave confirming, and the new ruleset card on the grid.](https://cdn.banksync.io/videos/enrichment-auto-categorize.7a48460397c10642.mp4) This guide walks through creating a Ruleset, previewing it against your real transactions, and applying it to a feed. > **Before you start:** 'You need a workspace where you can edit resources, and at least one saved feed with field mappings (so you have data to enrich and preview). If you have not built a feed yet, follow the feed walkthrough first.' ## What an enrichment does There are three enrichment types in BankSync. This guide focuses on Rules (rulesets), the most common one; Alerts and Memory are covered further down. - **Rule** — A ruleset of When conditions and Then actions that fills in field values automatically, with a live preview and match count against your feed. - **Alert** — Emails you when syncing data matches your conditions, with a cooldown so you aren't flooded. - **Memory** — Learns from the edits you make to synced records and reapplies those values to future matching records (one per workspace). A Ruleset is a list of rules. Each rule is read as "**When** these conditions match, **Then set** a field to a value." Rules run top to bottom, so order matters when more than one could apply. ## Step 1: Create a Ruleset You can start from the Enrichments page or from inside a feed. Starting from the feed is convenient because the new enrichment is automatically attached to that feed. 1. **Open a feed and go to Mapping** — Open the feed you want to enrich and select the Mapping tab. 2. **Open the Enrichments subtab** — Inside Mapping, switch to the Enrichments subtab (next to Fields). 3. **Create the enrichment** — Click Create enrichment (or the + Create new link). In the New Enrichment dialog, choose Ruleset. BankSync creates the Ruleset, attaches it to the current feed (left disabled until you finish configuring it), and opens its detail view. > **Starting from the Enrichments page instead:** 'You can also open Enrichments in the left navigation and click Add an enrichment, then pick Ruleset. Enrichments created this way are not attached to any feed yet, so you will attach one in Step 4.' ## Step 2: Set the data type In the enrichment detail view, the Configuration tab shows a **Data type** selector at the top. Choose the data type the rule should apply to (for most categorization, this is Transactions). The data type determines which fields are available in your conditions and actions. > **Changing data type clears your rules:** 'Field names differ between data types, so switching the data type after you have built rules will prompt you to confirm and then reset the conditions. Pick the right data type before building rules.' ## Step 3: Build the rule Each rule card has two parts: a **When** section (the conditions) and a **Then set** section (the action). 1. **Set the condition (When)** — In the When section, pick the field (for example Description), an operator (for example contains), and type the value to match (for example UBER). 2. **Add more conditions (optional)** — Click Condition to add another row. The AND / OR badge between rows controls whether all conditions must match or any of them. Use Group to nest a set of conditions. 3. **Set the action (Then set)** — In the Then set section, choose the field to fill (for example Category) and type the value to write into it (for example Transport). 4. **Add more rules (optional)** — Click Add rule to add another rule to the Ruleset. Drag rule cards by their handle to reorder them; rules run top to bottom, so put the most specific rules first. 5. **Name the rule** — Click the rule's title to rename it (for example "Rideshare") so the Ruleset is easy to scan later. Changes save automatically; the badge at the top of the dialog shows the save status. There is no separate Save button. ## Step 4: Apply the Ruleset to a feed A Ruleset only runs on the feeds it is attached to, and only when it is enabled. 1. **Attach to feeds** — Open the Dependencies tab in the enrichment detail view. Check the feeds you want this Ruleset to run on. Only feeds whose data type matches the enrichment are selectable; others show as incompatible. 2. **Enable it** — At the bottom of the dialog, flip the switch from Disabled to Enabled. > **Toggle from the feed instead:** In a feed's Mapping > Enrichments subtab, attached enrichments appear under Active Enrichments and workspace enrichments appear under Use Existing. Use the per-enrichment switch there to apply or remove an enrichment for that feed without opening its detail view. ## Step 5: Preview against real data The feed's Mapping tab has a **Live Preview** panel at the bottom that runs your current configuration (including enrichments) against your actual records, so you can check the result before syncing. 1. **Open Live Preview** — Go to the feed's Mapping tab and scroll to Live Preview. Pick a date range that contains transactions you expect to match. 2. **Check the Data tab** — The Data tab shows how rows will look in your connected sheet, database, or table. Cells changed by an enrichment are highlighted. 3. **Check the Enrichments tab** — Switch to the Enrichments tab to see each rule and how many records it matched. The count badge tells you at a glance whether your rule is firing. ![Enrichment Ruleset editor showing a rule named Shopping with a When condition Description contains AMZN and a Then set action setting Category to Shopping, above a feed Live Preview before/after table where the Category cells on the two matching AMZN transaction rows are highlighted as changed, with a 2-match count badge on the Enrichments tab.](https://cdn.banksync.io/screenshots/enrichments/rule-preview.bbc28ef3263226c0.png "The rule card (When / Then set) and the feed's Live Preview, with cells changed by the enrichment highlighted.") ## Confirm it worked You have a working enrichment when: - The Ruleset shows as **Enabled** and is attached to your feed (it appears under Active Enrichments in the feed's Enrichments subtab). - In Live Preview, the Enrichments tab shows a non-zero match count for your rule. - In the Data Live Preview tab, the target field (for example Category) shows your value on the matching rows, with the changed cells highlighted. After the next sync, those enriched values appear in your connected sheet, database, or table. > **Troubleshooting:** No matches in the preview? Confirm the rule's data type matches the feed, the enrichment is Enabled, and it is attached to this feed (Dependencies tab). If matches still show zero, loosen the condition: text matching is exact to what you typed, so check spelling and try contains instead of equals, and widen the preview date range so matching records are included. ## The other two types: Alerts and Memory Rules edit your data. The other two enrichment types use the same machinery for different jobs. You create them from the same New Enrichment dialog by picking **Alert** or **Memory** instead of Ruleset, and they attach to feeds and enable/disable exactly like a Ruleset. - An **Alert** uses the same When condition builder, but when a record matches during a sync, BankSync emails you instead of changing the record. See [Alert enrichments](/docs/enrichments/alerts). - A **Memory** enrichment learns from how you categorize records in your connected sheet, database, or table, and auto-fills those values on future matching records. One per workspace. See [Memory: auto-learn](/docs/enrichments/memory). ## Next steps Refine where enriched values land by reviewing your field mappings. [Configure field mappings](/docs/bank-feeds/field-mappings) ## Related guides - [Alert enrichments](/docs/enrichments/alerts): get an email when records matching your conditions sync. - [Memory: auto-learn](/docs/enrichments/memory): let BankSync learn your categorizations and apply them automatically. - [Configuring field mappings](/docs/bank-feeds/field-mappings): control which columns your enriched values land in. - [Creating your first feed](/docs/bank-feeds/creating-first-feed): build a feed first so there is data to enrich and preview.