Contacts in Refrens

The Contacts feature helps you store and manage the people you work with inside client, vendor, prospect, or lead organisations.

A company usually has more than one person involved in communication. One person may handle finance, another may manage procurement, and another may be your day-to-day point of contact.

Contacts helps you keep all these people organised in one place instead of storing only the company name.

A contact is a person.

A client, vendor, or lead is an organisation.

One contact can be linked to multiple organisations, and one organisation can have multiple contacts linked to it.

What you can do with Contacts

With Contacts, you can:

• create a separate record for each person
• link a contact to one or more clients or vendors
• mark one contact as the Primary contact for a client
• view all linked clients from the contact itself
• add contacts while creating or editing clients and vendors
• use linked contacts in documents such as invoices, quotations, proforma invoices, and credit notes

Where to find Contacts

Go to the Contacts menu from the left sidebar:

The Contacts dashboard has three tabs:

• Active Contacts shows the contacts you currently use in day-to-day work.
• Inactive Contacts shows contacts that have been archived and are not active anymore.
• Deleted Contacts shows removed records separately, so the main dashboard stays clean.

How Contacts work

Contacts are stored separately from organisations. This means the same person does not need to be created again for every client or vendor.

For example, if one consultant works with two different companies you deal with, you can store that person once as a contact and link them to both organisations.

Each link between a contact and an organisation is saved as a separate relationship. This allows you to store relation-specific information such as role, department, and primary status:

Create a contact

To add a new contact:

1. Go to Contacts menu from the left sidebar
2. Click Create New
3. Fill in the contact details & save

A contact record can include the details such as Name, Email, Phone, Tax Info (Aadhar, PAN, etc.), Social Profile Links, and Address:

View a contact

From the Contacts dashboard, open any contact using the View action:

The contact opens in a side drawer with two tabs:

Contact Details

This section shows the person’s saved information such as name, email, phone number, country, and other details added in the contact form.

Linked Clients

This section shows the organisations linked to that contact - helping you understand where the contact is connected and what role they hold for each organisation.

Edit, archive, or delete a contact

From the Contacts dashboard, open the row actions for a contact under 'More' options:

Available actions include:

• View
• Edit
• Mark as Inactive
• Delete

Use Mark as Inactive when the contact is no longer active but the record should still remain in the system.

Use Delete when the contact should move out of the active working list.

Link a contact to a client/vendor from the client/vendor edit Page

Contacts can be linked directly while creating or editing a client/vendor.

1. Just go to the Linked Contacts section in client/vendor creation/edit page
2. In Linked Contacts, click + Link Contact
3. Search for the contact
4. Select the contact from the results (If the contact does not already exist, you can also create a new contact from here)
5. Choose the relation type
6. Click Link

After the contact is linked, it will appear in the linked contacts table on the client form.

Mark a contact as Primary for a client

Each client can have one Primary contact.

The primary contact acts as the main point of contact for that client and is used in workflows where a default contact is needed.

To mark a contact as Primary

1. Go to the respective client/vendor from your Client/Vendor dashboard
2. Click on "Edit" and navigate to the linked contacts section
3. Click the row action menu ("More" option) for the contact
4. Select Mark as Primary

Only one contact can be primary for a client at a time.

Automatic primary assignment

When the first contact is linked to a client, it is marked as Primary automatically.

Unlink a contact from a client

If a contact is no longer associated with a client, you can remove the relationship without deleting the contact record.

To unlink a contact

1. Go to the linked contacts section on the client/vendor edit view page
2. Click the row action menu
3. Select Unlink
4. Confirm the action

This removes the contact from that client only.

The contact itself remains available in the Contacts dashboard and can still be linked to other organisations.

Link a client from the Contacts dashboard

A contact can also be linked to a client from the contact side.

This is useful when you already have the person saved and want to connect them to an organisation later.

To link a client from a contact

1. Open the contact from the Contacts dashboard
2. Go to the linked clients section, or use the dashboard action for linking
3. Search for the existing client
4. Select the client
5. Fill the relation details (Role, Dept.)
6. Save the relation

This creates a contact relation between the selected person and the selected client.

Remove a client from a contact

A linked client can also be removed from the contact side.

To remove the relation

1. Open the linked client row
2. Choose Unlink Client
3. Click Confirm

This removes only the relationship.

It does not delete:

• the contact
• the client
• any past document already saved on invoices or other documents

Use contacts in invoices and other documents

Contacts can also be used in bill documents such as Invoice, Quotation, Proforma Invoice, Credit Note, Purchase etc. wherever applicable

In these documents, the contact appears inside the Billed To section when the selected client has linked contacts:

How contact selection works in bill documents

When a client is selected on the document:

• if the client has a Primary contact, that contact is auto-selected
• if the client has linked contacts but no primary contact, you can choose one manually
• If no contact is linked to the client, you can link a new contact directly from the billed to section:

Choose which contact details appear on the document

After selecting a contact, choose which fields should appear on the document:

These options include:

• Name
• Email
• Phone
• Role
• Department

Name remains selected and cannot be removed. Other fields can be shown or hidden depending on what should appear on the PDF.

Remove a contact from a document

A contact is not mandatory on the document.

To remove it, just click on the "cross" icon:

This clears the contact from the document and removes those contact fields from the billed-to section.

How contact details are stored in documents

When a contact is used in a document, it gets stored in the document at the time of save.

This is important because the document should continue to show the same addressee even if:

• the contact is edited later
• the contact is unlinked from the client later
• the contact is archived later

The document keeps its saved contact snapshot unless the contact is selected again and re-confirmed from the document creation/edit page.

Best practices for using Contacts

• Search before creating a new contact. This helps avoid duplicate records.
• Use the Primary tag carefully. It should represent the main person your team usually communicates with for that client.
• Use Inactive status when a contact is no longer active but may still be needed for history or reference.

Frequently asked questions

Can one contact be linked to multiple clients?

Yes. A contact is stored separately from organisations and can be linked to more than one client or vendor.

Can one client have multiple contacts?

Yes. A client can have several linked contacts, with one marked as primary.

What happens when a contact is unlinked from a client?

Only the relationship is removed. The contact record remains in Contacts.

What happens if the primary contact is removed?

The primary designation is cleared. Another contact is not assigned automatically.

Can I remove a contact from an invoice?

Yes. The document can be saved without a contact if it is not needed.

Will editing a contact change older invoices automatically?

No. Documents keep a saved contact snapshot unless the contact is selected again from the document form.

Updated on: 20/04/2026