{"id":278,"date":"2026-08-17T08:14:46","date_gmt":"2026-08-17T08:14:46","guid":{"rendered":"https:\/\/www.rithmai.com\/support\/?post_type=ht_kb&#038;p=278"},"modified":"2026-08-17T08:15:22","modified_gmt":"2026-08-17T08:15:22","slug":"custom-client-fields","status":"publish","type":"ht_kb","link":"https:\/\/www.rithmai.com\/support\/knowledge-base\/custom-client-fields\/","title":{"rendered":"Custom Client fields"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Custom Client fields let you add extra information to every client record in Rithm\u2014details that the standard fields (name, account, phone, address, notes, and so on) do not already cover. Once you create a field, it appears on all of your clients so you can fill in the value that belongs to each person.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use this page to learn what Custom Client fields are, where they appear in the web app, and how to create, fill in, rename, delete, search, import, and bulk-update them.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What is it?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Every client in Rithm already has a set of built-in fields: name, account (organization), specialty, type, stage, importance, notes, contact details, visit preferences, and more. Those fields work well for most sales work. Your territory, though, often needs a few extra facts that are unique to your industry or your process.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Custom Client fields are extra text fields that you define. You choose the field name. Then, on each client, you type the value that applies to that client.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Typical examples:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Territory<\/strong> or <strong>Region<\/strong> \u2014 which area this client belongs to<\/li>\n\n\n\n<li><strong>Decision maker<\/strong> \u2014 who actually signs or influences the order<\/li>\n\n\n\n<li><strong>Preferred day<\/strong> \u2014 the day they usually take visits<\/li>\n\n\n\n<li><strong>Contract end<\/strong> \u2014 when a current agreement expires<\/li>\n\n\n\n<li><strong>Referral source<\/strong> \u2014 how you found them<\/li>\n\n\n\n<li><strong>Npi number<\/strong>, <strong>License<\/strong>, or another ID your company tracks<\/li>\n\n\n\n<li><strong>Buying group<\/strong> or <strong>Parent account<\/strong><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Rithm\u2019s own description of the feature is: add Custom Fields to track the unique business details, industry insights, and background information that standard fields miss. They help tailor your client records to fit your sales process.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A few important facts about how they work:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A custom field is a <strong>name plus a value<\/strong>. The name is the same for every client (for example, \u201cTerritory\u201d). The value can be different on each client (for example, \u201cNorth\u201d on one client and \u201cWest\u201d on another).<\/li>\n\n\n\n<li>After you create a field, it shows on <strong>every<\/strong> client record, even if that client does not have a value yet. Empty values display as <strong>&#8212;<\/strong>.<\/li>\n\n\n\n<li>Values are free-form text. There is no drop-down list of allowed answers. Type whatever you need, up to 255 characters.<\/li>\n\n\n\n<li>Field names are listed in alphabetical order.<\/li>\n\n\n\n<li>Rithm standardizes the field name when you save it: the first letter is capitalized and the rest of the name is lowercase. For example, \u201cterritory\u201d becomes \u201cTerritory\u201d, and \u201cNPI Number\u201d becomes \u201cNpi number\u201d.<\/li>\n\n\n\n<li><strong>Specialty<\/strong> already has its own place on the client card. Do not create a second custom field named Specialty.<\/li>\n\n\n\n<li>Creating, renaming, or deleting a field requires permission to edit clients. If you cannot edit clients, you will not be able to manage custom fields.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Where to find it in the UI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Custom Client fields show up in several places in the web app. The two you will use most often are the client record (to fill in values) and the Custom Fields page (to add, rename, or delete the fields themselves).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Changing a Custom Field value in a client record<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open <strong>Clients<\/strong> from the main menu (this may be labeled <strong>Accounts<\/strong> if your company uses that wording).<\/li>\n\n\n\n<li>Select a client to open the client detail page.<\/li>\n\n\n\n<li>In the client information area, look below <strong>Specialty<\/strong>, <strong>Importance<\/strong>, <strong>Stage<\/strong>, and <strong>Type<\/strong>. Each custom field appears there as its own labeled row, with the value beside it (or <strong>&#8212;<\/strong> if it is empty). <strong>Notes<\/strong> sits after the custom fields.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Managing Custom Field Names (add, rename, or delete fields)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This is the page titled <strong>Custom Fields<\/strong>. It lists every custom field name you have created, with an <strong>Edit<\/strong> button on each row and a <strong>+Add new<\/strong> button at the bottom.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can open it in any of these ways:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>From a client record: <strong>More<\/strong> (the &#8230; three-dot button) \u2192 <strong>Manage custom fields<\/strong><\/li>\n\n\n\n<li>From Settings: open <strong>Settings<\/strong> in the main menu \u2192 in the <strong>Maintenance<\/strong> section, choose the <strong>Custom fields<\/strong> button<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">If you have not created any fields yet, the list shows <strong>(There are no custom fields)<\/strong> until you add one.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Other places you&#8217;ll see Custom Fields<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">When you add a client on the web, any custom fields you have already created appear on the new-client form so you can fill them in at the same time as name, address, and the other standard fields.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Bulk editor<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Open <strong>Settings<\/strong> \u2192 <strong>Maintenance<\/strong> \u2192 <strong>Bulk edit clients<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In the bulk editor, each custom field appears in two places:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>For these<\/strong> \u2014 options such as \u201cTerritory contains\u201d, so you can find clients whose custom field matches a search<\/li>\n\n\n\n<li><strong>Do this<\/strong> \u2014 options such as \u201cChange Territory to\u201d, so you can set the same value on many clients at once<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">When you expand a client in the bulk editor results, that client\u2019s custom field values are listed with the rest of the details.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Auto-Scheduler<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Open <strong>Auto-Scheduler<\/strong> from the main menu. Under <strong>Create schedule only for these clients<\/strong>, each custom field appears as a \u201c{Field name} contains\u201d choice. You can limit a proposed schedule to clients whose custom field contains a word or phrase you type (for example, only clients whose Territory contains \u201cNorth\u201d).<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Import and Export<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">In <strong>Settings<\/strong> \u2192 <strong>Import\/Export<\/strong>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Import client wizard<\/strong> \u2014 when you map spreadsheet columns to Rithm fields, you can map a column to <strong>Custom Field<\/strong>. Rithm uses the spreadsheet column header as the custom field name and the cell as the value.<\/li>\n\n\n\n<li><strong>Export clients<\/strong> \u2014 exported files include your custom fields as their own columns so the extra details leave Rithm with the rest of the client data.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">How to use it<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Create a custom field<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the <strong>Custom Fields<\/strong> page (from a client\u2019s <strong>More<\/strong> menu \u2192 <strong>Manage custom fields<\/strong>, or from <strong>Settings<\/strong> \u2192 <strong>Maintenance<\/strong> \u2192 <strong>Custom fields<\/strong>).<\/li>\n\n\n\n<li>Choose <strong>+Add new<\/strong>.<\/li>\n\n\n\n<li>The page title becomes <strong>Add custom field<\/strong>. Type a short, clear field name (for example, Territory).<\/li>\n\n\n\n<li>Choose <strong>Save<\/strong>.<\/li>\n\n\n\n<li>You should see a confirmation such as \u201cCustom field was saved: Territory\u201d, and the new name appears in the list.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">If you leave the name blank and save, Rithm does not create a field. The message explains that no changes were made, and that to remove a field you use <strong>Edit<\/strong> then <strong>Delete<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If the name you typed is the same as the existing name, Rithm reports that no changes were made.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">After you add a field, open any client. The new label is there, with <strong>&#8212;<\/strong> until you enter a value.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Enter or change a value on one client<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the client.<\/li>\n\n\n\n<li>Click the custom field\u2019s value (or the <strong>&#8212;<\/strong> placeholder). An edit box appears, with <strong>Save<\/strong> and <strong>Cancel<\/strong>.<\/li>\n\n\n\n<li>Type the value. You can clear the box to remove the value.<\/li>\n\n\n\n<li>Choose <strong>Save<\/strong>. A success message confirms the update. Choose <strong>Cancel<\/strong> if you do not want to keep the change.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">If you are viewing another salesperson\u2019s clients rather than your own, Rithm will not let you edit. You will be asked whether you want to return to your own clients.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When several people share the same location (for example, you used <strong>Add another Client at this Location<\/strong>), a custom field value you save on one of those clients is copied to the other clients at that same location. That keeps shared facts in sync.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Fill in custom fields while adding a client<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Start a new client as you normally would. If custom fields already exist, they appear on the new-client form. Type a value for any that you know; you can leave the rest blank and fill them in later from the client record.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you realize you need a new field name before you save the client, use <strong>Manage custom fields<\/strong> or the <strong>Setup<\/strong> button, add the field, then return and complete the client.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Rename a custom field<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Renaming changes the label everywhere it is used, and keeps each client\u2019s existing value under the new name.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the <strong>Custom Fields<\/strong> page.<\/li>\n\n\n\n<li>On the row for that field, choose <strong>Edit<\/strong>. The page title becomes <strong>Edit custom field<\/strong>.<\/li>\n\n\n\n<li>Change the name.<\/li>\n\n\n\n<li>Choose <strong>Save<\/strong>.<\/li>\n\n\n\n<li>Choose <strong>Cancel<\/strong> (or <strong>Back<\/strong> from the list) if you decide not to rename it.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Use rename when the idea is the same and you only want a clearer label (for example, \u201cRegion\u201d to \u201cTerritory\u201d). Do not rename a field if you actually want a different piece of information; add a new field instead so you do not overwrite the old meaning.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Delete a custom field<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Deleting removes the field name <strong>and every client\u2019s value for that field<\/strong>. This cannot be undone from the Custom Fields page.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the <strong>Custom Fields<\/strong> page.<\/li>\n\n\n\n<li>Choose <strong>Edit<\/strong> on the field you want to remove.<\/li>\n\n\n\n<li>Choose <strong>Delete<\/strong>.<\/li>\n\n\n\n<li>Confirm when Rithm asks: \u201cDeleting a custom field name will also delete all the data in this field. OK?\u201d<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">If you only need to clear one client\u2019s value, edit that client and save a blank value instead of deleting the field for everyone.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Show custom fields in the Clients list<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open <strong>Clients<\/strong>.<\/li>\n\n\n\n<li>Open <strong>Columns to view<\/strong>.<\/li>\n\n\n\n<li>Check each custom field you want as a column. Names are marked <strong>(Custom field)<\/strong>.<\/li>\n\n\n\n<li>Choose <strong>Update<\/strong>.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">This is helpful when you scan a list by territory, buying group, or another extra detail. You can turn those columns off again the same way.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Update many clients at once (bulk editor)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Use this when the same custom field should change for a group of clients (for example, everyone in a city should get Territory = North).<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to <strong>Settings<\/strong> \u2192 <strong>Maintenance<\/strong> \u2192 <strong>Bulk edit clients<\/strong>.<\/li>\n\n\n\n<li>Under <strong>For these<\/strong>, choose the custom field \u201ccontains\u201d option (for example, \u201cCity contains\u201d or \u201cTerritory contains\u201d) and type what you are matching. You can also combine this with other filters such as stage or type.<\/li>\n\n\n\n<li>Under <strong>Do this<\/strong>, choose <strong>Change {field name} to<\/strong> and type the new value.<\/li>\n\n\n\n<li>Review the matching clients, then run the update.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Matching for custom fields is a <strong>contains<\/strong> search: it is not case-sensitive, and a partial word can match. Double-check the list before you apply a change to a large group.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Limit an Auto-Scheduler run by a custom field<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open <strong>Auto-Scheduler<\/strong>.<\/li>\n\n\n\n<li>Under <strong>Create schedule only for these clients<\/strong>, choose the \u201c{Field name} contains\u201d option.<\/li>\n\n\n\n<li>In <strong>Search for this<\/strong>, type the text to match.<\/li>\n\n\n\n<li>Build the schedule as usual. Only clients whose custom field contains that text are included (along with any other filters you set, such as importance range or stage).<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Bring custom fields in from a spreadsheet<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to <strong>Settings<\/strong> \u2192 <strong>Import\/Export<\/strong> \u2192 <strong>Import client wizard<\/strong>.<\/li>\n\n\n\n<li>Upload your spreadsheet and continue to field mapping.<\/li>\n\n\n\n<li>For each extra column that is not a built-in Rithm field, map it to <strong>Custom Field<\/strong>.<\/li>\n\n\n\n<li>Check the sample client on the mapping screen so the extra columns land in the right place.<\/li>\n\n\n\n<li>Finish the import. Rithm creates or updates the custom field names from those column headers and stores each row\u2019s cell as that client\u2019s value.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Name spreadsheet columns clearly before you import. Those headers become the field names (with Rithm\u2019s capitalization rule applied). Map name, address, phone, and other standard columns to the matching Rithm fields rather than to Custom Field, so you do not duplicate information that already has a home.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Export custom fields<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Use <strong>Settings<\/strong> \u2192 <strong>Import\/Export<\/strong> \u2192 <strong>Export clients<\/strong>. The download includes a column for each custom field, which is useful for a backup, a report, or a round-trip edit in a spreadsheet followed by another import.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Tips for getting the most from Custom Client fields<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Keep names short and specific.<\/strong> \u201cTerritory\u201d is easier to scan than \u201cWhich region of the country does this account sit in\u201d.<\/li>\n\n\n\n<li><strong>Use one name, one meaning.<\/strong> If two people type \u201cNorth\u201d and \u201cN. Region\u201d for the same idea, filters and bulk updates will miss some clients. Agree on wording with your team.<\/li>\n\n\n\n<li><strong>Do not recreate a built-in field.<\/strong> Name, account, address, phone, email, notes, specialty, type, stage, and visit preferences already exist. Custom fields are for what those do not cover.<\/li>\n\n\n\n<li><strong>Create the field once, then fill values per client.<\/strong> You do not add a new field for each client. You add the field once, then enter each client\u2019s answer.<\/li>\n\n\n\n<li><strong>Empty is allowed.<\/strong> Leave a field blank until you know the answer. Blank shows as <strong>&#8212;<\/strong>.<\/li>\n\n\n\n<li><strong>Rename carefully; delete even more carefully.<\/strong> Rename updates the label on all clients. Delete removes the field and all of its data.<\/li>\n\n\n\n<li><strong>Use columns and bulk edit for list work; use the client card for day-to-day visits.<\/strong> The client record is the natural place to glance at extra details before you walk in. The Clients list and bulk editor are better when you are organizing a whole territory.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">On iPhone<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The iOS app does not yet show Custom Client fields on client screens. You can still create and use them in the web app; those values are stored with the client and will be there when you open the record on the web. A future version of the iOS app may display them.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Custom Client fields let you add extra information to every client record in Rithm\u2014details that the standard fields (name, account, phone, address, notes, and so on) do not already cover. Once you create a field, it appears on all of your clients so you can fill in the value that&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[4],"ht-kb-tag":[27],"class_list":["post-278","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-clients","ht_kb_tag-clients"],"_links":{"self":[{"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/ht-kb\/278","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/comments?post=278"}],"version-history":[{"count":1,"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/ht-kb\/278\/revisions"}],"predecessor-version":[{"id":279,"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/ht-kb\/278\/revisions\/279"}],"wp:attachment":[{"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/media?parent=278"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/ht-kb-category?post=278"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.rithmai.com\/support\/wp-json\/wp\/v2\/ht-kb-tag?post=278"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}