Workspaces in Customer.io
Workspaces are a way of working with multiple products, sites or apps from a single Customer.io account. Everyone starts with one (its name is the same as your account name), and you can add or remove them as needed.
By default, new workspaces use both email and id as identifiersThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace.. You can change identifiers after you create your workspace.
- Click your workspace in the upper left corner and then click Manage all workspaces to go to the Workspaces page.
- Click Add.
- Give your new workspace a name and a custom color to help you differentiate between your workspaces.
- Set the default send behavior for the workspace:
- Send messages normally: All messages send as defined in your workflow.
- Test email delivery: Emails will send to a defined test address; other messaging types (Slack, webhooks, etc.) send as normal.
- Never send messages: Message delivery is disabled.
- Select the team members who can manage and access the new Workspace. You can’t disable access to a Workspace for an Admin; Admins can access all Workspaces in an account.
- Click Save.
When you’ve finished adding your workspace, you can switch between workspaces from the main navigation bar.
Click your workspace in the upper left corner and then click Manage all workspaces to see a list of your workspaces. From here you can add, edit or delete workspaces (if you have more than one).
To edit an existing Workspace, go to the Workspaces page and click ‘Edit’ in the Manage settings:
You can change your Workspace’s name, delivery settings or access permissions for team members. You can also change the color assigned to the Workspace to help you differentiate between them.
To remove a Workspace, go to the Workspaces page and click Delete.
You must type your Workspace’s name (case-sensitive) to delete it.
Deleted workspaces are not recoverable.
Deleting a workspace permanently deletes all campaigns, emails, customers, deliveries, metrics, and data contained within a workspace. Make sure you’re prepared to lose this data before you delete a workspace.
After you create a workspace, you can change settings by going to Settings > Workspace Settings > General Workspace Settings.
New workspaces treat email as an identifierThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace. by default, but you can disable it. Disabling email as an identifier only prevents you from using an email address to add or update people; you can still use it as an attributeA key-value pair that you associate with a person—like their name, the date they were created in your workspace, etc. Use attributes to target people and personalize messages..
The default configuration—in which email is an identifier—can be helpful for cases where you initially identify people who are interested in your product (leads) by email address and then assign them IDs later, when they become customers.
When you enable email as an identifier, we’ll automatically merge people who have the same address.
To enable or disable email as an identifier:
- Go to Settings > Workspace Settings and click General Workspace Settings.
- Click update your workspace next to
- Carefully read about the behaviors that will change for your workspace. When you’re ready, click Change configuration. If you’re enabling email as an identifier, we’ll merge people that have the same email addresses.
Changing your workspace configuration can take up to a day.
When you enable email or ID as identifiers, you may notice slightly different behaviors from other workspace types.
- Reporting Webhooks: the
customer_idkey is null if you add a person without an ID (by email only). You should update your endpoints to use the new
identifiersobject. See our webhook documentation for more information.
- Segment Source events: After you migrate, message opens, clicks, etc. for people without an
idare sent with the
anonymousId. You can map these anonymous events to another destination or drop them.
If your workspace uses both email and ID as identifiersThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace., this setting determines the requirements to change a person’s
In general, if you see a lot of failed “Attribute Change” requests in your workspace, or a significant number of your
identify calls fail, you might try turning this setting on. You can also try enabling the Multi-identifier profile merge.
This setting does not effect CSV imports
You cannot change a person’s
If your workspace uses email as an identifierThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace., you can change a person’s
But, if your workspace does not use email as an identifier, then you cannot change a person’s
id after you set by default. If you want to be able to change
id after you set it (using
cio_id) on the People page or through the API, you must change your workspace settings. This setting does not allow you to change
id values after they’re set through a CSV upload or database sync integration (MySQL, BigQuery, etc).
- Go to Workspace > Workspace Settings and click General Workspace Settings.
- Next to
id, select Reference people by cio_id.
Open tracking relies on a tracking pixel—a small image—in your messages; when a user opens an email containing the tracking pixel, the image loads from a remote location and tells us that a user opened the message.
However, open tracking is not always reliable. In the interest of user privacy, Apple and the makers of other email clients have started providing options to prevent images like tracking pixels from loading when users open messages; this prevents us from tracking open events. In some cases, email clients and corporate firewalls immediately download images when a person receives an email, causing us to record an open events even if a person didn’t actually open the message.
You can go to Settings > Workspace Settings > General Workspace Settings to disable open tracking at the workspace level and prevent tracking pixels from being added to your emails entirely. This setting overrides the message-level Track opens and link clicks in this message setting. Disabling open tracking this way can help you both respect your audience’s privacy and prevent you from focusing on sometimes-unreliable open rates, as opposed to clicks or conversions.
When you disable open tracking, open metrics for emails may still appear in some charts or tables (in campaign metrics, etc), but will always show zero results.
Whether you continue to track opens or not, we recommend setting conversion goals for your messages and tracking link clicks as more reliable ways to determine the success of your messages and campaigns.
If you isolate workspaces by project, client, app, or something else, you can limit your teammates’ access to certain workspaces.
Admins can access all Workspaces in the account. You cannot disable an admin’s access to a workspace.
No information is shared between Workspaces.
Workspaces are essentially separate instances of Customer.io. Each Workspace has its own people, campaigns, metrics, and other data.
You are billed for the number of profiles you have and messages you send across all Workspaces on your account.
Workspaces are completely separate instances of Customer.io, each with their own people and associated data. This prevents sharing information and potentially messaging the wrong person. However, you can copy workflow actions across Workspaces).
Although not designed specifically for testing, Workspaces can be used to set up testing/staging environments. Each Workspace is assigned its own set of API keys and are completely separate from your other Workspaces. Once you’re ready to migrate a Campaign or message from test to production, you can copy entire workflow actions from one Campaign to another across Workspaces.