Locating Dependencies: Where are my Contact Fields Used?

RapidPro.app lets you check where a contact field is referenced across your workspace (for example, which flows use it), which is helpful before renaming or changing a field, cleaning up old logic, or troubleshooting unexpected behavior linked to that field.

Find where a contact field is used in a few steps

If you just need the essentials, follow this:

  1. Open Contacts → Fields to access the fields list
  2. Locate the field you want to inspect (for example: Age)
  3. Click the link icon next to the field name
  4. Review the usage list (for example, which flows reference the field)
  5. If usage looks wrong, refresh and search flows for the field reference

You’re done. You can now identify dependencies before making changes.

Step-by-Step Process

1
Open Manage Contact Fields

  1. Go to Contacts.
  2. Click Fields.

[CAPTURE: Contacts page with the “Fields” button visible.]
[CAPTURE: Manage Contact Fields page showing the fields list.]

2
Find the field you want to inspect

In the fields list, find the contact field you want to inspect (for example, Age).

3
Open the field usage view

  1. Click the link icon next to the field name.
  2. Open the usage view/panel that appears.

[CAPTURE: Manage Contact Fields list showing a field (Age) with the link icon highlighted.]

4
Review where the field is referenced

Review the list of places where the field is used (for example, which flows reference that field).

[CAPTURE: “Field usage” panel/modal showing the flows where the field is referenced.]

5
Validate results if something seems missing

  1. If the list looks outdated, refresh the page and check again.
  2. If the list is empty but you still suspect usage, search your flows for the field reference (for example, @contact.fields.age).
  3. If you can’t access the usage view, confirm you have permission to view configuration details.

Common Issues & Quick Fixes

Problem: I don’t see the link icon next to a field.

Fix: Return to Contacts → Fields and confirm you’re on the Manage Contact Fields page. If it still doesn’t appear, ask an admin to confirm your permissions.

Problem: The usage list is empty, but I know the field is used.

Fix: Refresh the page and check again. If needed, search your flows directly for the field reference (for example, @contact.fields.age) to find where it’s used.