Veeva Settings
To streamline administration, Vault CRM uses custom settings called Veeva Settings stored on the veeva_settings__v object.
Ensure all users have at least read permission to the veeva_settings__v object and at least read permission to all fields on the veeva_settings__v object.
Who can use this feature?
- Browser Users
- Users do not require an additional license
- Business Admin Users
Configuring Veeva Settings for

Veeva Settings are similar to other custom objects and provide the ability to define specific application behavior for a Vault or profile
A Veeva setting uses built-in logic that lets you personalize settings for your Vault or for specific profiles. The logic checks the Vault and profile for the current user and returns the most specific, or lowest, value setting. Settings for a Vault are overridden by profile settings.
To view or edit a Veeva Setting:
- Navigate to Business Admin > Veeva Settings.
- Select the global veeva_settings__v record.
- Select Edit to make Vault level changes for one or more Veeva settings.
- Select Save.
When viewing the Veeva Setting detail page, the list of records in the Custom Fields section displays both configuration settings and strings (labels, error messages, etc.). Only configuration settings should be modified using Veeva Settings. Strings referenced by the application will continue to be administered using Veeva Messages.
Defining Profile Specific Veeva Custom Settings as

For information on creating profile-specific Veeva settings, see Configuring VMOCs or Settings for an Application Profile.
Only global and profile-level settings are supported. User Level Settings are not supported.
Business admin users can also configure other profile-specific custom settings, for example, Approved Email Settings or Multichannel Settings.
When using profile-level Veeva Settings, enable the Enhanced Sync setting on the VMOC for the veeva_settings__v object. This avoids a Force Full Refresh when users switch between profiles during integrations.
Using Veeva Settings and Veeva Messages
Veeva Settings are often populated by Veeva Messages.
For Veeva Messages containing text requiring a LongTextArea field type, special logic applies:
- The Veeva Setting contains text in the following format: MessageName;;MessageCategory
- The setting points to the Veeva Message in the category indicated within the setting’s text
- The actual value of the configuration is set within the Veeva Message
- You can still apply profile level settings, but you need to create separate copies of the Veeva Message that is pointed to by each of the settings
- Each Veeva setting displays as the original Veeva Message name
- The active Veeva Message for all configurations automatically migrates to the new Veeva setting; administrator action is not required as any customizations you have made are applied as the default value
- Vault level Veeva Settings cannot be deleted
- Only one application profile can be associated with a veeva_settings__v record
- Unlike Veeva Messages, modifications made to Veeva Settings are not overwritten during an upgrade
-
If you use Profile Specific Settings and the iPad platform, add the following to the WHERE clause to the VMOC for the message__v object. This ensures only the applicable profile specific settings synchronize:
WHERE application_profile__v = @@USER_APP_PROFILE_ID@@ OR (application_profile__v = null AND security_profile__v = null)