Gmail labels become Front tags
When you connect a Gmail account to Front, Front will sync your Gmail labels with your Front tags, including nested labels, as long as the channel is set to Gmail threading mode. If you use a different threading mode, tag activity will not sync between Gmail and Front. The tag sync also works differently for team inboxes and individual inboxes, so it’s explained more below.
For individual inboxes
When you connect a Gmail account with Front as an individual inbox, we’ll automatically create private tags in Front for each of your Gmail labels (this happens alongside your email history auto-import). For a tag to be created, you must have applied the Gmail label at least once to a conversation that is being imported.
Whenever you apply a label in Gmail, a private tag will be created for that label and applied to the message in Front. When you tag a message with a private tag or a team tag in Front, the message will be labeled in Gmail with a matching label. When you remove these labels or team tags in one system, the corresponding label or team tag will be removed in the other system.
For team inboxes
When you connect a Gmail account with Front as a team inbox, we will automatically import your Gmail labels as Front team tags. The process is the same as for an individual inbox.
Whenever you apply a label in Gmail, a team tag will be created for that label and applied to the message in Front. Same in reverse — when you tag a message with a team tag in Front, the message will be labeled in Gmail with a matching label. When you remove these labels or team tags in one system, the corresponding label or team tag will be removed in the other system.
If you apply a private tag to a message in a team inbox in Front, the message will not be labeled in Gmail. If you remove a label in Gmail that matches a private tag in Front, the private tag will not be removed.
How tag sync works
The following rules apply for tag sync with Gmail for both team inboxes and individual inboxes:
If a Gmail label name matches a tag that already exists, Front will not create a duplicate tag. The Gmail label will map to the Front tag that already exists with the same name.
The same is true in reverse — if a Front tag is applied that matches the name of a Gmail label, then a duplicate label will not be created.
If you have nested Gmail labels, Front will create tags using the same naming structure that Gmail uses when you apply a nested label: “Category name/Label name”. Front does not support nested tags, so separate tags will be created.
For example, say you have a category of labels in Gmail called Status, with the sub-labels To do, Underway, and Done. When you connect your inbox, Front will create three new separate tags called Status/To do, Status/Underway, and Status/Done.
If you move a conversation from your inbox into a label in Gmail, we will apply the matching tag and archive the conversation. If you move the message between labels in Gmail, we will also update the tags in Front, and the message will remain archived.
Unfortunately there is no way to avoid archiving due to Gmail’s API. If this is an issue for your workflow, we recommend only applying the label in Gmail instead of moving the message out of your inbox into the label folder.
Deleting and renaming labels and tags
When you delete a label or tag in one system, the corresponding label or tag is not deleted in the other. You will need to delete both the label and tag manually.
The same applies for renaming tags and labels — you will need to update the name of the corresponding tag or label in the other system. Otherwise, you will end up with two separate tags or labels in the other system: one for the old name and one for the new name.
For example, say you have an Urgent label with a matching Urgent tag in Front. If you rename Urgent to High Priority in Gmail and apply that label, you will create a new tag called High Priority in Front (in addition to the Urgent tag). To keep them in sync, you should update the Front tag to High Priority before using the renamed label.
Backing up your tags
If you need a backup, you can export tag information via Front's API.
The Starred section of your private Gmail inbox will sync to Front with a history import, but team inboxes will not sync the Starred section. Learn more about the Starred section here.