Back to the Knowledge Base

Knowledge Base Article

How To Manage Classification Codes in Argenta

Classification codes are the dropdown lists behind almost every field in Argenta: document categories, event types, donation categories, volunteer needs, lead status codes. Set them up the way your organization actually talks, and everyone picks from the same list instead of typing their own version of the same thing.

Where to find them

Click Classification Codes in the main menu. You get every code type in Argenta, more than 200 of them, laid out as tiles and grouped alphabetically.

  • Search. Type in the box at the top right to narrow the tiles. The number beside it shows how many matched.
  • The A to Z bar. Click a letter to jump to that group. Letters with nothing under them are greyed out.

This page is for master builders and administrators. If it is not in your menu, ask an administrator on your team.

The Classification Codes page showing the search box with a count of codes, the A to Z bar, and the first row of code tiles

1 search the tiles, and the number underneath shows how many matched. 2 jump to a letter. Letters with nothing under them are greyed out.

Add a new code

  1. Go to Classification Codes and click the tile for the list you want, for example Document Categories or Event Types.
  2. Click the add tile at the top of the grid. It is named for whatever you are editing, so on Document Categories it reads Add A New Document Category.
  3. Type the name. Most lists hold 150 characters and a few hold 50, so the box counts down from the limit for the list you are on. Apostrophes are not allowed.
  4. Click the button in the modal (it is also named for what you are adding, such as Add Document Category) or just press Enter.

The new value is live right away, everywhere that dropdown appears.

Add one without leaving the record you are on

You do not have to walk over to Classification Codes every time. Wherever a classification code dropdown sits on a record, master builders and administrators see a small orange plus icon next to it. Click it, type the new value, click Save, and it drops straight into the list you are standing in.

Why you cannot rename a code, and what to do instead

There is no rename, and that is deliberate. Once a code is sitting on hundreds of records, changing the words underneath them quietly rewrites your history and your reports along with it.

The safe way to change a name:

  1. Add a new code with the name you want.
  2. Move the records off the old code onto the new one. On a list page, tick the records and use the Change Classification Code for Selected Records bulk action.
  3. Remove the old code once nothing is using it.

Remove a code you no longer use

  1. Open the code list and find the value you want gone.
  2. Click the circle x on its tile.
  3. Confirm when Argenta asks.

If nothing is using the code it goes straight away. If records still carry it, Argenta tells you what it is attached to in your own words rather than table names, for example 12 donors and 3 volunteers, and offers to take the code off all of them first. Read that confirmation before you accept it, because it cannot be undone. Say yes and Argenta clears the code off those records, deletes it, and tells you how many records it touched.

Two things will still stop you, both on purpose:

  • Some records have to keep a value. Where the field cannot be left empty, Argenta names what is still holding the code and asks you to move those records onto a different option first.
  • It is a system code. Values marked with a lock and a System badge are part of how Argenta works. They have no delete button at all.

A classification code list showing the dashed add tile, a code marked SYSTEM, and the remove button revealed on a hovered tile

Hover a tile to bring up its remove button. The dashed tile at the top adds a new value, and anything marked SYSTEM has no remove button at all.

Removing a code takes it off your organization's list. It does not go digging through other organizations' data.

Good habits

  • Set your codes up before you start entering data. Reworking a taxonomy after a thousand records are sitting on it is a much bigger job than getting it right on day one.
  • Pick a naming convention and hold to it. "Annual Fund" every single time beats "Annual Fund" some days and "annual fund gifts" on others.
  • Prune once a year. Codes nobody picks anymore just make the dropdown longer for everybody.
  • Remember these feed your reports. Clean codes are the difference between a report you trust and one you have to explain.

Every change is logged

Adding or removing a code writes an entry to the Activity Log with your name and the time, so you can always see who changed the taxonomy and when. See How to Use the Activity Log to Track Record Changes.

Classification codes also show up as filter options on nearly every list. See How To Filter Lists in Argenta.

Reconnecting…

Whoops!

You've Encountered An Error

Something went wrong on our end. Don't worry, our development team has already been notified, and we'll get it fixed as soon as we can.

Please avoid repeating the same action for now. A quick reload usually gets you going again.