Collections
5 minutes read | Level: Beginner | Last Updated: October 2025 |
Collections
Collections is a feature in Glific to keep one set of users in one place and use it to communicate with all users in that collection in one go.
Create a Collection
- Click on the
Manage
in the left panel of the Glific screen. Click onCollections
to access the collections page
- Collections page will open up. Click on the
+Create
to create a collection
Assign staff to a Collection
-
Add details of the Collection
Title
- Description
Assign staff members
to the collection who will be chatting with the contacts in the collection.
Click on save
after adding the details.
- Verify the collection created on the collections page.
Add beneficiaries to Collection (Manually)
b. Add contacts to the collection. From Add contacts
pop up, select the contacts from the dropdown and click on the Save
button.
Send a message to the Collection
Send a message
orstart a flow
with all contacts of a group. Go toChats
page and click oncollections
icon from the right hand menu.
2 . Click on the collection to which you want to send a message or HSM template.
3 . Type the message in the Type a message box and Clink on send
Icon.
or
click on the up arrow and go to templates
button to select the approved HSM template.
4 . Variable input box will open up. Enter the variable and click on Done
button
5 . Message will appear in message input box. Click on send icon to send the HSM template to all contacts in the selected collection.
6 . A contact status message popup will open up. Click on OK, send button to send the message.
7 . Verify the message sent to the contacts
Start a flow for the Collection
1 . Click on the arrow
icon next to the collection name.
2 . Click on start a flow
menu item. Select the flow from the drop-down and click on start
button to start a flow for all the contacts in the collection.
Get a list of all the collections contact is part of
Use contact.in_groups
lists all the group ids that the given contact is part of.
Bulk Import and Update Contacts
Glific offers two key features to help manage contacts efficiently:
- Import Contacts (Add new contacts in bulk)
- Move Contacts (Update contact fields or add contacts to a collection)
These tools are especially helpful during onboarding, data migration, or large-scale updates.
1. Import Contacts
When to Use
Use the Import Contacts feature when you need to add new contacts in bulk into the Glific Platform.
For example:
-
Onboarding a new group of users.
-
Migrating from another CRM system.
-
Adding participants for an upcoming campaign or event.
How to upload contacts in bulk
Steps
-
Login to
Glific Platform
. -
In the left panel navigate to
Manage
and selectContacts
-
Find the
Import
contacts(left side) and click Continue.(as shown in the below image)
- Download the sample csv and provide the information of the contacts in the format of the sample csv(as per the below screenshots)
- Select the collection where the contacts will be added (it is advised to add contacts being uploaded in a new collection)
-
Check the
Opt-in
status. -
Click on
upload
file, this allows you to upload the csv file from your computer. -
Click on
upload
- Check the notifications page to see the status of the upload.
Important Notes
-
Ensure that the country code is present in the phone number without
+
-
This feature uploads all the contacts into the platform and does not validate the phone number (if it is less than 10 digits or if the number exists on WhatsApp or not). Any invalid number which gets added, when broadcasted to, will not get the message.
-
Language field is to provide the language preference. Leaving it blank will cause the language preference to be the default language selected in the org’s Glific platform.
-
Contacts blocking the chatbot can lower your quality rating with Meta.
-
Always import in small batches to avoid message delivery issues or account flagging.
2. Move Contacts (Bulk Update)
When to Use
Use the Move Contacts feature to:
- Add existing contacts to specific collections
- Update custom contact fields (e.g., language, location, group, status)
This is especially useful when:
-
Used to segment users for campaigns (e.g., surveys, reminders)
-
Used to update location, interest, or status based on recent interactions.
-
Used to tag contacts by region or type (e.g., Maharashtra Contacts, Grade).
-
Can be used for bulk updates without creating duplicate contacts.
How to move contacts
Steps
-
Login to
Glific Platform
. -
Navigate to
Manage
andContacts
from the left panel. -
Go to
Import Contacts
(right side). -
Click on
Download sample
and download the sample CSV file from the screen.
- Enter the details in the given sample data in excel and save it as .csv file. Enter the name of the collections in the collection column comma separated in which you want to move the contacts.
- Please use the below .csv file format.
name: The contact’s name.
phone: The contact’s phone number in E164 format (without +
).
collection: Enter the names of the collections where the contact should be added.
- If a contact needs to be added to multiple collections, separate them with a comma (as shown for John Doe).
some_contact_field_1, some_contact_field_2: Additional contact fields to update or create.
-
Here is the sample CSV file for reference:
contact_fields_csv.csv
-
Click on
upload
file, this allows you to upload the csv file from your computer. -
Click on the
upload
button to process the file. -
After upload:
- Check for successful updates in the Notifications tab
- Fix any errors (e.g., invalid phone format) and re-upload if needed
Example Use Cases
-
Adding all users from a school to a SchoolA Collection.
-
Updating contact field language to Hindi for 500 users.
-
Moving feedback participants to a Survey Completed collection.
Important Notes
-
CSV file must match the sample format exactly.
-
You can add multiple fields in one go (e.g., collection + language).
-
Opt-in is still required for sending messages after the update.