---
title: Clients (create, edit, delete)
description: This article will take you through the Client creation, edit, and deletion processes.
---

[Skip to content](https://support.pantrysoft.com/clients#main-content)

English

Show submenu for translations

[More support](https://support.pantrysoft.com/kb-tickets/new?hsLang=en)

![pexels-caleboquendo-7807594](https://support.pantrysoft.com/hs-fs/hubfs/pexels-caleboquendo-7807594.jpeg?width=3480&height=892&name=pexels-caleboquendo-7807594.jpeg)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [More support](https://support.pantrysoft.com/kb-tickets/new)
- [Go to pantrysoft.com](https://app.pantrysoft.com/login)

[Go to pantrysoft.com](https://app.pantrysoft.com/login)

 Welcome to the PantrySoft knowledge base. How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://support.pantrysoft.com/?hsLang=en)
2. [Additional Admin Guides](https://support.pantrysoft.com/additional-admin-guides?hsLang=en)
3. [Client Registration & Visits](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#client-registration-visits)

# Clients (create, edit, delete)

## This article will take you through the Client creation, edit, and deletion processes.

> #### **Getting Started:** Create at least one sample Client

#### Definition

A ***Client*** in *PantrySoft* is basically a household. For Users with an Org or Admin login (as opposed to Users assigned to the Kiosk interface), this record and all its associated records are represented on a single screen called the Dashboard Screen. This article will show you how to modify Client records in the Dashboard interface.

<iframe src="https://player.vimeo.com/video/798178661?h=4bbfe397a6&amp;badge=0&amp;autopause=0&amp;player_id=0&amp;app_id=58479" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen style="position:absolute;top:0;left:0;width:100%;height:100%;" title="Client Records (Add, Edit, Delete)"></iframe>

Because a Client record is the root record for your customers in the app, it "owns" or "has" household members, registration events, visit events, and its address. In reports and elsewhere, Client records are usually "named" after the primary household member, which is the person at the top of the Household Member widget in the dashboard's center column. Clients must always have a primary household member, who is given a relationship of "*Self*." In the Dashboard interface, a Dashboard screen loaded with a Client record contains separate widgets for all of the associated records mentioned above.

---

#### "Loading", "Remembering", and "Abandoning" Clients on the Dashboard Screen

*The Dashboard screen in PantrySoft will let you "load" a Client record, and afterwards it will "remember" this choice when you return to the screen. This section covers how to load a Client record, save that record, and clear the Staff Dashboard.*

### "Loading" a Client

![Client search image](https://support.pantrysoft.com/hs-fs/hubfs/Client%20search%20image.png?width=688&height=136&name=Client%20search%20image.png)

Assuming some Clients have already been entered into your system, the first and most basic act for intake staff or volunteers will be finding a client and loading them into the Staff Dashboard. When first logging in, a user will see a Staff Dashboard— a search bar just beneath the menu and nothing else (see figure above). From here, you can load a client into the Staff Dashboard with the search bar.

*Here's how to find and load a client:*

1. **Access the Client Search Bar**  
   Click on the *Search For Client* field.
2. **Type Your Query**Enter the client's data. Phone number, address, first and last name of any household member or proxy, and account number if you use them.
3. **The App Will Offer Suggestions as You Type** 
     - **Click the suggestion.** Clicking on a suggestion will load that client.
     - **One suggestion left.** Hitting Enter or clicking Search when only one suggestion remains will load that client.
     - **More than one suggestion.** Hitting Enter or clicking Search when more than one suggestion remains will load an entire index of relevant search results. Choose one and click Enter to load that client.

> **In-App Client Links.** Hyperlinks to other clients (for instance, on some of our client reports) will route you to the Staff Dashboard and load the new client into it. This "forgets" the former client-choice.

### "Remembering" a Client

Remembering a Client in dashboard mode is automatic. After loading a client, *PantrySoft* will remember which client you've selected and keep that client loaded into the Staff Dashboard until you choose to look at another. If you click on the PantrySoft logo in the top left corner, it will return you to the same client you last chose.

---

### "Abandoning" a Client

If you need to clear the Staff Dashboard of all client information, navigate to **Pantry-\>Client Search**. This will clear the client from the session and give you a fresh start.

---

#### Creating Client Records

*This section covers how to record a new client's information, as well as how to edit records for existing clients.*

![](https://support.pantrysoft.com/hubfs/image-png-Jun-15-2022-05-34-35-29-PM.png)

 

*Perform the following steps to create a new user and choose its role(s):*

1. **Load the Staff Dashboard**  
   Navigate to **Pantry-\>Client Search** or otherwise pull up the Staff Dashboard.
2. **Create a New Client**  
   Click on ***New Client***. *This pops up a Create New Client window.*
3. **Enter the Primary Household Member's Information** (see aside below for an explanation of a "Primary" Household Member)  
   Fill out any required fields, which can include: First, Middle, and Last Name, **Birth, Gender, ID Fields, Phone Number, and Email Address.**
4. **Enter Household Information**  
   Fill out any required fields: **Street Address, Postal Code, City, County, State, Account Number, Client Since**.
   
   ***NOTE: Barcodes as Account Numbers.*** To use a pre-printed bar code as the client's account number, put your cursor into the Account Number field and scan the physical bar code with a bar code scanner (this step requires that you purchase and set up a scanner for this purpose). The code will automatically appear in the field, and from here on, you'll be able to scan the barcode to find this client again in the PantrySoft client search.
5. **Save the Entry**  
   Click **Save and Exit**. This will close the window and reload the Staff Dashboard with the specifics for the new client and household member.

> **Client and its Primary Household Member.** PantrySoft takes the information you provide in the New Client pop-up and creates two related objects: a Client (the entire household), and a Primary Household Member. Client records cannot exist without at least one household member; there are no "empty" clients/households.

#### Editing a Client

*PantrySoft uses the information you entered in the New Client process to create a number of "widgets" on the Dashboard Screen (i.e., PantrySoft created a Household Member widget for the primary member, an Address widget, and a core Client info widget for info like Account Number and Status). This section will show how to modify those records specific to the Client record itself.*

*(**NOTE:** To learn how to modify a Client's roster of Household Members, Proxy members, and other optional records like Documents, search for specific articles here in our Knowledge Base.)*

### Editing Core Attributes

*Perform the following steps to edit a client’s core attributes:*

1. **Load the Staff Dashboard**  
   Navigate to the Staff Dashboard.
2. **Access the Client**  
   Load the target client into the Staff Dashboard.
3. **Access the Client's Record**  
   Click the pencil icon to the right of "Client Since". This will display the Client Edit pop-up.
   
   ![](https://support.pantrysoft.com/hubfs/image-png-May-15-2023-05-06-17-4892-PM.png)
4. **To "Deactivate" a Client**  
   If you want to retire the client so they no longer appear in client searches (but their past activity remains open to reporting ), change the Status to *Inactive*.
5. **Make Any Needed Edits**  
   Adjust Account Number or Client Since as desired.
6. **Save the Changes**  
   Click **Save and Exit**.

> **Missing Attributes?** If you're attempting to change something not covered in this section, consider that the attribute you're looking for may belong to another record which you would change in its own Staff Dashboard widget. For instance, Household Members "own" their own phone numbers or email addresses, so that information is in the Household Member widget. Custom questions that rightly "belong" to the entire household are usually located in Registrations.

### Editing a Client Address

*Perform the following steps to edit the client’s address:*

1. **Load the Staff Dashboard**  
   Navigate to the Staff Dashboard.
2. **Access the Client**  
   Load the target client into the Staff Dashboard.
3. **Access the Client's Records**  
   Click the icon to the right of "Address"  
   ![](https://support.pantrysoft.com/hubfs/image-png-May-15-2023-05-09-59-5165-PM.png)
4. **Make Any Needed Edits**  
   Adjust address fields as necessary.
5. **If You Were Simply Correcting a Mistake in the Address**  
   Click Save Correction.
6. **If the Client Moved**  
   Click Save New Address. This “retires” the address but makes it available to historical reports.

---

#### Deleting a Client

*Perform these steps to permanently delete a client's records:*

**WARNING**: Do not perform this operation unless absolutely necessary (See explanation below)

Deleting a client is more involved than deleting other PantrySoft records because clients are the central record to which all other records are attached (i.e., a Client “has” proxies, household members, visits, etc.). Deleting a Client means deleting all its attached records. This will erase its presence in the past (i.e., visit reports will no longer account for a deleted client’s visits). To ensure the user is aware of the implications behind deleting a client, you must first delete its attached records manually.

*To delete a client, first, delete all of its attached records:*

- **Delete Client Household Members except for the Primary Household Member**  
  (NOTE: You cannot delete the primary household member manually, but it will be automatically deleted with the last of the final series of steps.)
- **Delete Client Notes**
- **Delete Client Proxies**
- **Delete Client Visits**
- **Delete Client Appointments**
- **Delete Client Registrations**

*Perform the following steps to delete the client once all the client’s attached records have been deleted:*

1. **In the Client's Record, Click On the Edit Client Icon to the Right of Client Since:**
   
    ![](https://support.pantrysoft.com/hubfs/image-png-May-15-2023-03-23-04-7507-PM.png)
2. **Delete the Client**  
   Click **Delete**. This will prompt a confirmation.
3. **Confirm the Deletion**  
   Click and hold on the red confirmation **Delete** button. This will delete the client record and the Primary Household Member, and then return you to a blank Staff Dashboard.

- [Getting Started](https://support.pantrysoft.com/getting-started?hsLang=en#main-content)

    - [Users](https://support.pantrysoft.com/getting-started?hsLang=en#users)
    - [PantrySoft Interfaces](https://support.pantrysoft.com/getting-started?hsLang=en#pantrysoft-interfaces)
    - [Inventory](https://support.pantrysoft.com/getting-started?hsLang=en#inventory)
    - [Guest/Client Registration](https://support.pantrysoft.com/getting-started?hsLang=en#guest-client-registration)
    - [Visits](https://support.pantrysoft.com/getting-started?hsLang=en#visits)
    - [Client Portal - Scheduling](https://support.pantrysoft.com/getting-started?hsLang=en#client-portal-scheduling)
    - [Reporting](https://support.pantrysoft.com/getting-started?hsLang=en#reporting)
- [Additional Admin Guides](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#main-content)

    - [Client Registration & Visits](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#client-registration-visits)
    - [Additional Features](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#additional-features)
    - [Inventory Management](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#inventory-management)
    - [Additional Paid Features](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#additional-paid-features)
    - [Tags](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#tags)
    - [Scheduling Appointments](https://support.pantrysoft.com/additional-admin-guides?hsLang=en#scheduling-appointments)
- [Scheduling and Schedule Templates](https://support.pantrysoft.com/scheduling-and-schedule-templates?hsLang=en)
- [User Interfaces](https://support.pantrysoft.com/user-interfaces?hsLang=en#main-content)

    - [Client Portal/ Online Store- Admin & Setup Guides](https://support.pantrysoft.com/user-interfaces?hsLang=en#client-portal-online-store-admin-setup-guides)
    - [Client Portal/ Online Store- Customer Guides](https://support.pantrysoft.com/user-interfaces?hsLang=en#client-portal-online-store-customer-guides)
    - [Packing/ Kitchen Screens and Reports](https://support.pantrysoft.com/user-interfaces?hsLang=en#packing-kitchen-screens-and-reports)
- [Special Workflows](https://support.pantrysoft.com/special-workflows?hsLang=en#main-content)

    - [Delivery/Meals on Wheels](https://support.pantrysoft.com/special-workflows?hsLang=en#delivery-meals-on-wheels)
    - [University](https://support.pantrysoft.com/special-workflows?hsLang=en#university)
- [FAQ & Miscellaneous](https://support.pantrysoft.com/faq-miscellaneous?hsLang=en#main-content)

    - [Client Troubleshooting](https://support.pantrysoft.com/faq-miscellaneous?hsLang=en#client-troubleshooting)
    - [Other FAQs](https://support.pantrysoft.com/faq-miscellaneous?hsLang=en#other-faqs)
    - [Messaging and Notifications](https://support.pantrysoft.com/faq-miscellaneous?hsLang=en#messaging-and-notifications)
    - [Other Reports](https://support.pantrysoft.com/faq-miscellaneous?hsLang=en#other-reports)
    - [Technical Documentation](https://support.pantrysoft.com/faq-miscellaneous?hsLang=en#technical-documentation)
- [Reporting Tools](https://support.pantrysoft.com/reporting-tools?hsLang=en#main-content)

    - [Merging Duplicate Client Accounts](https://support.pantrysoft.com/reporting-tools?hsLang=en#merging-duplicate-client-accounts)
- [Release Notes](https://support.pantrysoft.com/release-notes?hsLang=en#main-content)

    - [2026 Releases](https://support.pantrysoft.com/release-notes?hsLang=en#2026-releases)
    - [2025 Releases](https://support.pantrysoft.com/release-notes?hsLang=en#2025-releases)
    - [2024 Releases](https://support.pantrysoft.com/release-notes?hsLang=en#2024-releases)
- [Recorded Webinars](https://support.pantrysoft.com/recorded-webinars?hsLang=en#main-content)

    - [2026 Webinar Recordings](https://support.pantrysoft.com/recorded-webinars?hsLang=en#2026-webinar-recordings)
    - [2025 Webinar Recordings](https://support.pantrysoft.com/recorded-webinars?hsLang=en#2025-webinar-recordings)
- [Special/ Niche Features](https://support.pantrysoft.com/special-niche-features?hsLang=en)
- [Advanced Inventory](https://support.pantrysoft.com/advanced-inventory?hsLang=en)
- [CSFP Module](https://support.pantrysoft.com/csfp-module?hsLang=en#main-content)

    - [CSFP Overview](https://support.pantrysoft.com/csfp-module?hsLang=en#csfp-overview)
    - [Managing CSFP Participants](https://support.pantrysoft.com/csfp-module?hsLang=en#managing-csfp-participants)
    - [Recording CSFP Visits](https://support.pantrysoft.com/csfp-module?hsLang=en#recording-csfp-visits)
    - [CSFP Data Management](https://support.pantrysoft.com/csfp-module?hsLang=en#csfp-data-management)
- [PantrySoft Volunteer](https://support.pantrysoft.com/pantrysoft-volunteer?hsLang=en)

# PantrySoft

pantrysoft.com Help Center

Copyright © 2026, PantrySoft