Skip to content

Adding & editing dictionary entries

A dictionary is just its entries — pairs of a real value and the fixed replacement it should always get. Here’s how to manage them by hand in the manager.

Click Add entry, then fill two fields:

  • Original — the exact value as it appears in documents (Acme Ibérica SL).
  • Replacement — what it should always become (Globex Hispania SA).

Save, and the pair joins the table marked as Manual in the source column.

Each original maps to exactly one replacement. If you add a pair whose original already exists, the new replacement overwrites the old one — you never end up with two conflicting entries for the same term. This is what guarantees a value resolves the same way every time the dictionary is used.

So to change a mapping, just add it again with the new replacement; to retire one, delete it.

The pencil on any row reopens the same two fields. Edit either side and save. Editing is how you correct a fake value you’ve decided you don’t like, or fix a typo in an original that stopped it from matching.

The trash removes a single pair. Piixie confirms first. Deleting is permanent for that dictionary — but if the pair came from a run, the run’s history still records it.

A dictionary entry matches its original as written. Acme Ibérica SL won’t catch Acme Iberica (no accent) or ACME IBÉRICA. For anonymization, add the forms that actually appear in your documents. (Reverse deanonymization is more forgiving — it can match values that differ only in case or accents — but for forward anonymization, match what’s really in the text.)

For a lot of pairs at once, the fastest path is usually:

  1. Run a document and let synthetic mode generate good values.
  2. Promote that run into a dictionary in one step.
  3. Tidy up by hand here.

You can also Copy all as CSV from one dictionary and use it as the basis for another.