Managing Vault CRM User Preferences in Align
In Vault CRM, preferences__v records are associated with user__v records and employ Veeva-provided and customer-created business logic to impact how users interact with Vault CRM. For example, the event_country_config__v field enables admins to define a user’s default country when creating an event, simplifying the event creation process. Align operational users can manage these user preferences via aln_roster_member__v records.
Who can use this feature?
- Align Operational Users - Browser
- Resetting Vault CRM User Passwords
- Users require an Align License
Configuring Managing Vault CRM User Preferences for

To configure this feature:
- Ensure Configuring Align is complete.
- Navigate to Admin > Users & Groups > Permission Sets.
- Select the appropriate permission set.
-
Select the Objects tab.
-
Grant the following permissions:
Object
Object Permissions
Fields
Field Permissions
aln_roster_member__v
CRE
- crm_events_user__v
- crm_event_country_selection__v
- crm_event_country_config__v
- preferences_timezone__v
Edit
aln_field_mapping__v
CRE
- mapped_crm_object_for_field__v
Edit
- Navigate to Admin > Configuration > Objects > aln_roster_member__v > Layouts.
-
Place the following fields on the appropriate layouts:
- crm_events_user__v
- crm_event_country_selection__v
- crm_event_country_config__v
- preferences_timezone__v
- Navigate to Align Admin > Align Settings (Production).
- Select the Global Align Setting record.
- Add the preferences__v value to the Manage CRM Features multiselect picklist.
- Select Save.
Mapping Preference Fields
After enabling this feature, admins can define which aln_roster_member__v fields in Align to map to preferences__v fields, including custom fields:
-
Create custom aln_roster_member__v fields for each custom preferences__v field you want to map.
Ensure the integration user has Edit permission to these custom fields.
- Add the appropriate custom aln_roster_member__v fields to the aln_roster_member__v layout.
- Navigate to Align Admin > Integrations.
- Select the Gear icon next to the Vault CRM instance in the Vault CRM section.
- Select View Field Map.
- Select the Align Objects tab.
- Expand the Roster Member Fields section.
- Select Describe & Edit.
-
Edit and activate the appropriate custom field mappings:
Align Field
Vault CRM Object
Vault CRM Field
crm_events_user__v
preferences__v
event_management_user__v
crm_event_country_config__v
preferences__v
event_country_config__v
preferences_timezone__v
preferences__v
time_zone__v
Custom aln_roster_member__v fields
preferences__v
Custom preferences__v fields
- Select Save.
Managing Preferences Records in Align as

When an Align-mastered roster member is created in Align and pushed to Vault CRM, a preferences__v record is also created and associated with the new user__sys record in Vault CRM.
If the user already has an associated preferences__v record, the preferences__v record updates based on the aln_roster_member__v fields mapped to preferences__v fields in Vault CRM. If multiple preferences__v records exists for the same user, all preferences__v records are updated based on the aln_roster_member__v fields in Align.
Admins can review preferences__v record updates in the aln_roster_member__v successes and failures CSV file generated as part of the Push to CRM process.