Manually Editing Values in the Contact Profile

You can edit contact data in RapidPro.app in three main ways: manually from a contact’s profile (best for one-off fixes),
in a flow using Update Contact (best for automation), or by import (best for bulk updates).
Default fields include a contact’s Name, Groups, and Addresses (URNs).

1. Go to Contacts and open the contact you want to edit.
2. Click Edit (top right).
3. Update any default fields you need (name, groups, addresses).
4. Save your changes.

[CAPTURE: Contact profile page with the “Edit” button highlighted.]
[CAPTURE: Edit Contact dialog showing Name, Groups, and Addresses/URNs.]

Add an address (connection)

1. In the Edit Contact dialog, use Add Connection to add an address (URN).
2. Choose the URN type you need (for example: phone number, Telegram ID, email, or other supported types).
3. Save when done.

[CAPTURE: Edit Contact dialog with “Add Connection” dropdown expanded.]

Prioritize addresses

1. Use the up-arrow / priority controls next to addresses to change which address is primary.
2. The top-most address is considered the priority.
3. Address priority influences outbound messaging, especially when multiple channel types are connected.

[CAPTURE: Address list showing priority arrows and the top-most address as primary.]

Custom fields can be updated manually on an individual contact or automatically in a flow using Update Contact.

1. Open the contact’s profile.
2. Click Fields.
3. Replace the old value with the new value.
4. Save.

[CAPTURE: Contact profile with “Fields” opened and custom field values editable.]

To edit fields through automation:

1. Open (or create) a flow.
2. Add an Update Contact action.
3. Select the field to update (or type a new field name to create it).
4. Set the value using variables like @results or expressions.
5. Save and test.

[CAPTURE: Flow editor showing an “Update Contact” action node.]
[CAPTURE: Update Contact configuration dialog showing field selection + value.]

You can update contact field values in bulk by importing a spreadsheet that includes the contact field column(s) you want to update
and the values for each contact.

[CAPTURE: Import spreadsheet example showing field columns and values.]

Adding addresses via import (requires UUID)

Addresses (URNs) can be added via import (not replaced), as long as you include the contact’s UUID column. You can obtain UUIDs by exporting contacts first.

[CAPTURE: Spreadsheet showing UUID + a new address column filled for existing contacts.]
[CAPTURE: Contacts export option/menu showing where to export to obtain UUIDs.]

Editing date values

When you manually enter a date-only value (without a time) into a Date & Time field, RapidPro.app may set or replace the time portion based on the moment you saved the update.

[CAPTURE: Editing a Date & Time field manually, showing a date entered and time auto-populated/updated.]

Replacing addresses

At this time, contact addresses (URNs) can be replaced only by editing the contact in the contact profile, or using the Contacts API endpoint.

[CAPTURE: Contact profile address list showing an address being edited/replaced.]