In This Article
- Executive Summary
- Why These Questions Belong Before the Signature
- Question Set One: Does Your Content Fit the Vault Data Model?
- Question Set Two: What Will You Clean, Migrate, Archive, or Leave Behind?
- Question Set Three: How Will You Validate the Migration Itself?
- Question Set Four: How Will You Stay Validated Through Three Releases a Year?
- Question Set Five: What Connects to Vault, and Who Owns Each Interface?
- Question Set Six: Is the Timeline Realistic?
- What to Settle in the Contract and Statement of Work
- Conclusion
- For Further Reading
- References & Sources
Executive Summary
A Veeva Vault migration is usually sold as a software decision, but most of what decides its outcome is settled in the order form and statement of work: how many sandboxes you have and how large they are, who owns the migration, which Vaults belong to which domain, and when go-live falls against Veeva’s release calendar. Once those are signed, changing them becomes a change order.
This article sets out six groups of questions to answer before you sign, drawn from Veeva’s own migration and release documentation and from the GMP requirement that a migration must not change data in value or meaning. The groups cover data model fit, legacy cleanup and archiving, validation of the migration itself, the validation workload from three general releases a year (confirmed in Veeva’s release documentation), integrations, and timeline realism. By our count, the 26R2 Release Impact Assessment listed 419 features on its main tab, 283 of them switched on automatically.
The article is neutral on the product. It does not argue for or against Vault. It argues that pharma and biotech teams should know what they are buying into, in writing, before the first document moves.
Why These Questions Belong Before the Signature
In our experience, many migration problems in regulated document and quality systems are not caused by the target platform. They come from assumptions made during the sales cycle that nobody wrote down: that legacy audit trails would come across, that the sandbox would hold a full dry run, that the validation team could absorb vendor releases on top of the migration, or that the integration to the learning system was “standard.” Each of those assumptions has a concrete answer in Veeva’s published documentation. The work is to find the answer and put it in the contract before the pressure of a go-live date takes over.
Veeva describes two kinds of migration. A legacy migration replaces an older system with Vault and usually happens during implementation. An incremental migration adds data to a Vault that may already be live, for reasons such as a phased rollout, a system consolidation, or an acquisition.7 Moving content between Vault applications, or merging two Vaults after a deal, falls into the second group. The same rules apply to both, and the second group carries an extra risk: you are loading data into a production system that people are using that day.
A note on names. Veeva now uses product names such as Veeva QualityDocs, Veeva QMS, and Veeva Clinical Operations in its developer documentation, and all of them run on the Vault Platform.7 This article uses “Vault” for the platform and the product name where the application matters.
What the Contract Fixes in Place
Several things that shape a migration are commercial terms, not technical choices. Veeva’s help documentation states that customers are entitled to four Small, two Medium, and one Full configuration sandbox for each production Vault, and that more sandboxes are an add-on order.13 Veeva’s migration guidance says customers can run a migration themselves, use Veeva Migration Services, or use a Certified Migration Partner, and it recommends talking to the account team about those options before the project starts.7 Domain structure matters for integrations between Vaults, as covered below. None of these is hard to settle during negotiation. All of them are harder to change after signature.
EU GMP Annex 11, as adopted in the PIC/S GMP Guide, also expects formal agreements with third parties that provide, configure, validate, maintain, or host a computerized system, with clear statements of each party’s responsibilities.14 A migration involves at least three parties: your company, Veeva, and often an implementation or migration partner. The division of work among them is exactly what that clause is about.
Six Groups of Questions
Does Your Content Fit?
Document types, lifecycles, objects, picklists, versions, and relationships. What maps cleanly, what needs redesign, and what cannot come across in its current state.
What Moves, and What Stays?
Deduplication, picklist normalization, open and closed records, legacy audit trails, and the decision to migrate, archive, or retire each class of content.
How Will You Prove It?
A validated migration process, dry runs, a validation run, and verification that data did not change in value or meaning.
How Will You Stay Validated?
Three general releases a year, plus limited, maintenance, and AI releases. Who reads the impact assessment and who tests in the four-week window.
What Connects, and Who Owns It?
Standard Veeva Connections versus custom interfaces, domain requirements, and end-to-end testing across system boundaries.
Is the Plan Realistic?
API threading limits, notification rules, sandbox capacity, release weeks, and cutover planning written into Veeva’s own guidance.
Question Set One: Does Your Content Fit the Vault Data Model?
Every document management or quality system has its own way of describing content. Legacy systems often grew over years of local decisions: a document type added for one site, a free-text field that stands in for a controlled list, a “status” that means different things in different departments. Vault expects content to arrive already shaped to its configuration. Veeva’s migration best practices tell teams to review the structure of the Vault data model, through the Vault Configuration Report or the Document Metadata API, to understand which metadata values must be populated.8
The first question, then, is not “can we move our documents?” It is “have we designed the target configuration in enough detail that we can write a mapping for every document type we own?” If the answer is no, the migration plan depends on a configuration that does not exist yet.
Map Types, Lifecycles, and Reference Data Before You Map Documents
Veeva’s guidance states that when document or object fields reference object records or picklists, the reference data must exist in Vault first.8 In practice this means products, sites, departments, organizations, and similar lists have to be agreed, cleaned, and loaded before a single document can be mapped to them. In quality and regulatory programs, these lists are often where the real disagreement is. Two sites may name the same product differently. A regulatory team may track a product family that quality does not recognize.
For objects that link to other objects, Veeva notes that record IDs change between Vault environments, so teams should use a lookup table or an object lookup field keyed on name or external ID rather than hard-coded IDs.9 That is a small technical point with a planning consequence: your mapping has to be environment-independent from the first dry run, or it will break every time you move from sandbox to validation to production.
Version Numbers and Lifecycle States Will Not Carry Over As They Are
Veeva assigns major and minor version numbers itself. The major version starts at one and increases when a document reaches a new steady state, and the minor version resets to zero at that point. Veeva’s guidance warns that some legacy systems let users assign their own version numbers, and others start at zero, so legacy version numbers may not match what Vault creates.8 If your SOPs, training records, or batch documentation cite version numbers, decide before signature how the legacy number will be preserved (for example, in a dedicated field) and how users will find a document by its old identifier.
Lifecycle states raise a sharper question. Veeva’s best practices say that source documents in “In” states such as In Review or In Approval, other than In Progress, should not be migrated, and that Vault will not apply workflows to migrated documents.8 The QualityDocs guidance adds that you cannot update the lifecycle state of a previous document version through the Vault API. If an earlier version is loaded in the wrong state, it has to be deleted and uploaded again.10 Both points push the same way: finish or cancel in-flight review and approval work in the legacy system before extraction, and get the state mapping right in the dry runs, not in production.
Binders, Relationships, Annotations, and Signature Pages
Four smaller items often turn into large tasks:
- Binders. Veeva does not recommend migrating legacy documents into binders because the operation is slow and complex. It suggests reviewing the legacy structure and using field filters to achieve similar results.8 If a legacy system relies on folders or compound documents to express meaning, that meaning has to move into metadata.
- Document relationships. For QualityDocs, version-specific relationships must name the versions they point to.10 A legacy “related documents” list that simply points to “the latest” needs a decision.
- Annotations. Veeva’s guidance sets out a load order for annotation types and notes that line annotations cannot be created through the API.8 If reviewer comments on legacy documents are part of the record, confirm what will and will not come across.
- Signature pages. Legacy signature pages must be in PDF format to be migrated.8 For QualityDocs, Veeva describes importing them as renditions and temporarily enabling a setting that stops Vault from generating its own overlay on the first version.10 That is a configuration step with validation implications, and it should be in the migration specification.
Compare Against a Neutral Reference Model
A vendor’s data model is one answer to “how should this content be described?” It is useful to have a second, vendor-neutral answer to compare against. For regulatory information, the DIA RIM Reference Model V2.0, published by the DIA RIM Working Group in 2026, defines business entities, attributes, and relationships for regulatory processes. Its authors state that sponsors, technology vendors, and system integrators can use it as a starting point for RIM implementations and data harmonization, and that it is not a formal standard.16 The guide also lists the information regulatory systems exchange with quality, safety, manufacturing, and clinical systems, which is a useful checklist when you plan integrations.
The point is not to force Vault into another model. It is to catch gaps. If the reference model expects a relationship between a registration and a manufacturing site, and neither your legacy system nor your planned Vault configuration captures it, you have found a design question before it became a migration defect.
For Moves Between Vaults, Check the Domain First
Teams moving content between Vault applications, or consolidating Vaults, should ask which domain each Vault is in. Veeva’s help documentation states that standard Veeva Connections require the connected Vaults to share the same domain.12 Veeva also provides one production domain and one sandbox domain, and says user acceptance testing Vaults should be in the sandbox domain.13 If a planned consolidation or a new application depends on a standard connection, confirm the domain arrangement in the order form.
Data Model Questions to Answer Before You Sign
- Is the target configuration designed in enough detail to write a mapping for every legacy document type and record type?
- Who owns the reference lists (products, sites, organizations, departments), and when will they be cleaned and approved?
- How will legacy version numbers and legacy identifiers be preserved and searchable?
- What happens to documents and records that are mid-review or mid-approval on cutover day?
- Which binders, relationships, annotations, and signature pages are part of the regulated record, and how will each come across?
- For Vault-to-Vault moves, are the source and target in the same domain, and does any planned connection depend on that?
Question Set Two: What Will You Clean, Migrate, Archive, or Leave Behind?
The hardest migration is the one that moves everything. Every document, record, and field that crosses over has to be mapped, transformed, loaded, and verified. Every one that stays behind needs a documented reason and a place to live for the rest of its retention period. This is a decision for quality, regulatory, records management, and legal to make together, and it is much easier before a fixed-price statement of work assumes an answer.
Clean in the Source, Not in the Load File
Veeva’s QualityDocs guidance recommends cleansing data where possible by removing duplicate documents in the source system and normalizing picklist values to a standard list, naming organizations, products, and facilities as examples.10 Its general data transformation guidance adds a list of smaller issues that break loads or corrupt values:9
- Trailing spaces in metadata, often after commas.
- Numbers stored in text fields that must keep leading zeros, which means migrating them as text.
- Long text values that exceed the field length configured in Vault. Veeva notes that Vault Loader does not truncate these values, so the load fails instead.
- References to people. User and Person records must be active to be referenced, and Veeva suggests referencing a Person record for people who have left the company or changed their name. User and Person names are not unique, so external IDs must be used.
- Records whose name is not unique. Veeva recommends setting an external ID to link each record to its legacy identifier, which also helps when reading success and failure logs.
The people question deserves a specific note for pharma and biotech. Quality records carry the names of authors, approvers, and trainers who may have left years ago. If the plan assumes those names will appear on migrated records, someone has to create and maintain the matching Person records, and someone has to decide how former employees are represented. That is a data governance decision, not a load-script detail.
Close What You Can Before Extraction
Veeva’s QMS guidance is direct about open and closed records. It recommends closing old in-flight records before extraction. Open records must be migrated into a lifecycle state from which a workflow can be started. For closed records, Veeva says it does not recommend migrating them, and if they must be migrated, it recommends using the legacy data model for QMS, which gives a standard structure for importing legacy data.11 The same guidance notes that records with a long life, such as change controls, are the more common candidates for migration, and that Veeva sees less commercial justification for migrating records with a life of only a few months, giving CAPAs as its example, because they are usually closed in the legacy system and archived.11
For document control, the QualityDocs guidance says to avoid migrating in-flight processes such as document change controls, and if they must be migrated, to bring them across in a steady state such as Initial or Final. It also notes that implemented document change requests may not work properly once migrated, because their associated change control does not exist in Vault.10 Documents midway through a periodic review cycle need their next review date set from the legacy review period.10
These are not reasons to avoid Vault. They are reasons to plan a legacy close-out campaign: a defined period before cutover in which open deviations, change controls, and document changes are either completed in the old system or deliberately carried across with a documented plan.
Decide Where Legacy Audit Trails Will Live
Legacy audit trails do not become Vault audit trails. Veeva’s migration guidance states: “The audit trail can only log events that take place in Vault. You cannot insert external records into your Vault’s audit trail.”8 Veeva’s recommended approach is to create a raw object for legacy audit trails, enable attachments, attach each audit trail to a record, and relate the document to that record. Veeva also warns that migrating legacy audit trails can significantly affect migration time and performance.
This has two consequences. First, someone must decide in what form the legacy audit trail is kept: as attached files in Vault, in a separate archive, or in a retained read-only copy of the legacy system. Second, whatever the form, it has to stay readable and retrievable for the full retention period. Annex 11 says archived data should be checked for accessibility, readability, and integrity, and that when relevant changes are made to a system, the ability to retrieve the data should be ensured and tested.14 ISPE’s GAMP Guide: Records and Data Integrity includes an appendix dedicated to record retention, archiving, and migration, which is a useful reference when writing that part of the plan.15
Veeva’s sandbox documentation adds a related detail: when a sandbox is created or refreshed, Vault does not audit the creation of records brought over during cloning.13 That does not matter for production data, but it matters if anyone plans to treat a sandbox copy as evidence of anything.
Migrate, Archive, or Retire: A Decision Table
A simple way to structure the conversation is to classify each type of legacy content into one of four outcomes, with a named owner and a reason for each.
| Outcome | Typical Content | What It Requires | Watch For |
|---|---|---|---|
| Migrate as active | Effective SOPs, current specifications, open records that must continue | Full mapping, lifecycle state mapping, reference data, verification | Open records must be loaded into a state that can start a workflow |
| Migrate as legacy | Superseded versions, closed records needed for reporting or trending | A legacy data model or legacy document types, clear labeling | Users confusing legacy records with active ones |
| Archive outside Vault | Old closed records, legacy audit trails, content past active use but inside retention | A validated archive, retrieval procedure, retention schedule | Readability for the full retention period after the legacy system is gone |
| Retire | Content past its retention period, duplicates, drafts never approved | A records disposition decision signed by the right owners | Legal holds and ongoing investigations |
A Lesson From Outside Pharma
Published, detailed accounts of regulated document migrations are rare, but a 2025 paper in the Journal of Pathology Informatics describes a comparable decision in a hospital pathology department replacing its laboratory information system. The team migrated ten years of pathology data into the new system and sent older data to a separate, integrated archiving solution, a choice the authors say was made because of financial constraints.17 Their verification found that the initial migration had not transferred autopsy and supplemental reports. After that was fixed, concordance between legacy and new systems was 214 of 221 reports (96.8 percent), with the remaining issues listed and analyzed.17
The setting is clinical, not GMP, but the pattern carries over: a deliberate cut between migrated and archived data, a verification step that found a whole category of content missing, and a written account of the residual differences. That is what a migration looks like when it is done carefully.
Question Set Three: How Will You Validate the Migration Itself?
Validating Vault as configured and validating the migration are two different things. The first shows the system does what your requirements say. The second shows that the content you moved is the content you had. Annex 11 states the requirement plainly: “If data are transferred to another data format or system, validation should include checks that data are not altered in value and/or meaning during this migration process.”14
“Value and/or meaning” is the phrase to plan around. A date that arrives intact but ends up in the wrong field has kept its value and lost its meaning. A document that arrives with the right content but the wrong lifecycle state has done the same. Verification must look at both.
Validate the Process, Then Verify the Result
Veeva’s migration overview lists the general steps: extract from the legacy system, transform data, resolve data quality issues, stage data and files from production in a sandbox, run dry runs, run a validation run, then load and verify in production.7 A validation plan for the migration can follow the same order.
Migration Specification
Scope by content type, the migrate, archive, or retire decision for each, field-level mappings, transformation rules, state mappings, and acceptance criteria. This is the document every later step tests against.
Tool and Script Qualification
Evidence that the extraction and load tools do what they claim. Veeva recommends Vault Loader or Certified Migration Partners, whose tools it says have been tested and certified. Custom scripts need their own testing.
Dry Runs
Test logic, data, and timing. Veeva notes that dry runs do not need full data volumes, because logic and timings can be checked with smaller sets. Failures are fixed in development before moving to test.
Validation Run
A controlled, documented run in a sandbox against pre-approved acceptance criteria, with deviations recorded and resolved.
Production Load and Verification
Batch loads before cutover, a delta load on cutover, and post-load verification, followed by a migration summary report that states what moved, what did not, and why.
The dry-run and tool points in the list above come from Veeva’s best practices, which recommend Vault Loader or Certified Migration Partners and say that logic and timings can be validated with smaller datasets.8
What Verification Should Check
Veeva’s guidance lists the checks it expects after data is migrated:8
- The expected numbers of documents and transactional records arrived, with no loss of data.
- Fields are correctly populated for each document and object type, transformations worked, and lookup fields point to the right records.
- Documents, renditions, and versions migrated correctly, which Veeva suggests checking with Vault Query Language (VQL) against renditions, metadata, and checksums.
- Migrated data is in the correct lifecycle state.
- Permissions on migrated data are set correctly.
Veeva also notes that Vault Loader can include created field values in its output log, which is useful evidence, and that for large migrations indexing can take several hours, so verification should allow for a delay before documents appear in search, renditions, or thumbnails.8 A verification step that runs too early will report false failures.
Counts and checksums can usually be verified for every item. Field-level meaning is where sampling comes in, and the sample should follow risk. Effective SOPs, master batch records, and specifications deserve a heavier sample than superseded training materials. Our earlier article on data quality regression testing after system migrations sets out one way to design those tests.
Treat Migration Settings as Privileged Configuration
Vault offers settings that make large loads possible by relaxing normal behavior. Veeva describes Document Migration Mode as a setting that loosens some constraints Vault normally enforces, and notes that Vault does not send notifications in this mode. Record Migration Mode allows object records to be created in non-initial lifecycle states with system fields set, and a No Triggers option can bypass system, standard, and custom Java SDK triggers. Both require specific permissions in the migration user’s security profile.8
These are legitimate tools, and they are also exactly the kind of capability an inspector would ask about. The migration validation plan should state who holds the permissions, when they are granted and removed, and what evidence shows they were used only for the approved loads. Veeva recommends a dedicated migration service account so that any record created during migration clearly shows it was part of the migration.8 That recommendation is worth adopting as a requirement.
One more practical point from the same guidance: after documents are migrated, scheduled jobs such as periodic review and expiration may send large numbers of emails to users.8 Plan for it, tell users in advance, and check that migrated review dates are correct before those jobs run.
Question Set Four: How Will You Stay Validated Through Three Releases a Year?
The release cadence is worth confirming from the source rather than repeating from memory. Veeva’s release documentation confirms it. Vault general releases arrive approximately every four months, and Veeva names them by year and sequence (for example, the first, second, and third general releases of a year are YYR1, YYR2, and YYR3).1 Veeva’s validation features brief says it supports validation for customer Vaults three times a year.5
General releases are not the only changes. Veeva also describes:1
- Limited releases roughly every three to five weeks, for Vaults on limited release servers, aimed at customers who want early access and can tolerate some instability.
- General maintenance releases, typically weekly, containing fixes. Veeva states that defects affecting functionality with high and medium GxP risk go through additional operational qualification for GxP regression before release.
- Vault AI releases on a faster cadence, named by year and calendar week. Veeva states that changes with significant GxP validation impact or needing configuration coordination are held for the next general release.
A multitenant platform means every customer on the same release track moves together. The question for a buyer is not whether releases will come. It is who in your organization will assess each one, how long they have, and what evidence they will produce.
Those figures come from our own count of Veeva’s published 26R2 Release Impact Assessment workbook, main “Veeva Vault RIA” tab, as last updated August 7, 2026. The tab covers application families including Platform, Clinical Operations, Quality, Regulatory, Safety, and Veeva Connections. Separate tabs for eCOA and sites and for QualityOne and RegulatoryOne are not included in the count.4 Most customers license a handful of applications, not all of them, so the number of features that matter to any one company is smaller. For the Quality application family alone, the same tab lists 66 features, 37 of them Auto-on and 6 rated High GxP risk.4 The point is not the total. It is that every release produces a list that someone must read, filter to your applications, and assess.
What Veeva Provides and What Stays With You
Veeva describes a substantial vendor contribution. Its release documentation states that Veeva performs and documents installation qualification and operational qualification (IQ and OQ) for each general release.1 Its validation features brief says Veeva gives customers access to a validation package for each release that includes a validation project plan, requirements documents, a test protocol, IQ/OQ, traceability matrices, and a validation summary report. It says Veeva risk-assesses every new or updated feature, and that a comprehensive revalidation of all system functionality is performed every two years. It also says Veeva regularly hosts customer audits on request.5
The same brief is clear about what remains with the customer: a user requirements specification written under the customer’s own validation method, and user acceptance testing or performance qualification (PQ) to confirm that the configured system, including security profiles, workflows, document taxonomies, and picklists, meets business requirements.5 Vendor evidence reduces the work. It does not transfer accountability for the validated state of your configuration.
| Activity Each General Release | Vendor Role (Per Veeva) | Your Role |
|---|---|---|
| Impact assessment | Publishes the Release Impact Assessment with enablement setting, GxP risk, and default impact per feature | Filter to licensed applications, assess against your configuration and procedures, document the decision |
| IQ and OQ | Performs and documents for each major release; provides a validation package | Review the package, file it, reference it in your change record |
| Regression of your configuration | Provides a prerelease sandbox copied from your configuration | Run risk-based UAT or PQ in the prerelease window |
| New optional features | Marks features that need configuration or an admin checkbox | Decide whether to enable, and handle it through change control when you do |
| Training and procedures | Publishes release notes and feature descriptions | Update SOPs, work instructions, and training for visible changes |
The Four-Week Window
Veeva’s prerelease FAQ describes prerelease as a four-week period before general availability of a new version, in which customers can explore it in a prerelease Vault based on their production configuration. It states: “Any user acceptance testing (UAT) or validation testing should be done in this period.”3 The FAQ adds that the prerelease sandbox copies configuration only, that participation is not required, and that prerelease sandboxes stay available for four weeks after the general release.3
The published 26R2 schedule shows how tight that window is in practice. Prerelease Vaults became available to all PODs, together with the validation package on VeevaDocs, on July 13, 2026. The release reached general release PODs on August 7, 2026.2 That is 25 calendar days. A team that plans to test in that window needs named testers, pre-written scripts, and a way to escalate findings quickly.
| Milestone | 26R2 (Published) | 26R3 (Proposed, Subject to Change) |
|---|---|---|
| Release Impact Assessment available | Last updated August 7, 2026 | October 5, 2026 |
| Prerelease Vaults for early PODs | June 29, 2026 | October 19, 2026 |
| Prerelease Vaults for all PODs | July 13, 2026 (with validation package on VeevaDocs) | November 2, 2026 |
| Release to early and limited release PODs | July 31, 2026 | November 20, 2026 |
| Release to general release PODs | August 7, 2026 | December 4, 2026 |
Dates above are from Veeva’s “About the 26R2 Release” page, which states that all dates are in US Pacific Time and subject to change.2
Build the Release Procedure Before Go-Live, Not After
A white paper written by members of Veeva’s customer quality community sets out a risk-based approach to managing Vault configuration changes and releases, aligned with ICH Q9, ICH Q10, and GAMP 5.6 It draws the distinction that matters most for release planning: features that are enabled automatically at upgrade versus features that are enabled through configuration at the customer’s discretion. It argues that this lets teams prioritize assessment at the feature level instead of applying the same rigor to every change, and it proposes graded levels of change oversight tied to risk.6
That is a sound basis for a release SOP. The RIA workbook gives the inputs directly: an enablement setting (Auto-on, Configuration, or Admin Checkbox), a GxP risk rating, and a default impact such as visible to all users or visible to admins only.4 A practical procedure might route Auto-on features with high or medium GxP risk in your licensed applications to targeted regression testing, route configuration features to normal change control only when you choose to enable them, and document a short rationale for everything else. The exact thresholds are yours to set and justify.
A question worth asking the sales team. How many people, for how many days, do comparable customers in your application set assign to each general release? Ask for the answer in terms of roles and effort, then check it with reference customers. Your migration team will be doing this work in parallel with the migration if go-live falls near a release.
AI Releases Follow a Separate Schedule
Veeva now describes a separate, more frequent deployment model for some Vault AI capabilities, with no downtime and, in Veeva’s words, changes with significant GxP validation impact held for the next general release. It says agent documentation, including risk-assessment materials, is published on its compliance documentation Vault.1 Whether or not you plan to use AI features at go-live, your release procedure should say how AI releases are monitored, who decides whether an AI feature is in use for a GxP process, and how that decision is recorded.
Question Set Five: What Connects to Vault, and Who Owns Each Interface?
A document or quality system rarely stands alone. Training assignments flow from document effective dates. Change controls reference regulatory registrations. Deviations from clinical operations may need to reach quality. HR systems feed user accounts, single sign-on controls access, and ERP or MES systems may consume specifications. Each connection is a place where migration and release changes can break something without anyone noticing until an audit.
Put the Interface Inventory in Scope
Annex 11 expects an up-to-date system description for critical systems covering data flows and interfaces with other systems or processes.14 It also says systems exchanging data electronically should include built-in checks for the correct and secure entry and processing of data.14 Before signature, list every interface the legacy system has today and every interface the Vault program plans, with an owner, a direction of data flow, the data exchanged, and whether it is standard or custom. Anything not on the list will not be in the statement of work.
Standard Connections Versus Custom Integrations
Veeva offers standard Veeva Connections between Vault application families, such as a Quality to RIM connection. Its help documentation says these connections aim to exchange data in near real time, ideally in about ten minutes, and handle duplicate documents and records across Vaults. It also says standard connections require the connected Vaults to share the same domain, and it strongly recommends working with a Veeva representative to gather and implement requirements because connections are a complex feature set.12
Standard connections are maintained by Veeva as part of the product and are covered by its release process. Custom integrations built on the Vault API or SDK are yours to maintain. Veeva’s migration guidance points out practical limits that also apply to integrations, such as API rate limits and the need to check limits on each call.8 The questions to settle are who builds each custom interface, who tests it against each general release, and who is called when it fails overnight during a batch release.
Test Across System Boundaries, Not Just Within Systems
The pathology migration paper cited earlier makes this point from experience. The authors report that workflows crossing the interface between the hospital’s electronic medical record and the new laboratory system were the most vulnerable, and that those workflows were not thoroughly tested before go-live, partly because they were outside the scope of the validation the team was asked to perform.17 The lesson for a Vault program is simple: make end-to-end scenarios that cross system boundaries a named part of someone’s validation scope.
Integration Questions to Answer Before You Sign
- Which interfaces exist today, and which will be retired, rebuilt, or replaced by a standard Veeva Connection?
- Are all Vaults that need a standard connection in the same domain?
- Who builds, validates, and supports each custom integration, and is that in the statement of work?
- How will integrations be regression tested in each prerelease window?
- Who owns end-to-end test scenarios that cross system boundaries?
Question Set Six: Is the Timeline Realistic?
Go-live dates are often set by a contract end date on the legacy system, a budget year, or an inspection window. None of those is a reason the migration can physically finish on that date. Veeva’s own guidance contains several constraints that belong in any schedule, and it tells customers to conduct performance testing to estimate how long migration activities will take.7
Constraints Written Into Veeva’s Guidance
- Threading. Veeva states that migrations using multiple threads are not supported and strongly recommends factoring this into project timelines. Document API endpoints support one thread, and object API endpoints support two.7
- Advance notice. Customers must notify Veeva at least three business days before a migration, or at least one week for large migrations, using the Vault Migration Planning Form. Veeva asks for the form for any migration over 10,000 documents, 1,000 large documents over 1 GB, or 500,000 object records, and for each environment.7
- Release weekends. Veeva states that migrations should not be planned for the weekend following Vault general releases.8 It also recommends not making configuration changes the week of a general release, and says raw objects may be locked from configuration changes that week if affected by data model changes.1
- File staging. Veeva recommends uploading files to staging well in advance because it takes time, and warns that Vault deletes files on the staging server after one year, with no recovery.8 A long, stop-start program can lose staged content.
- Renditions and indexing. Generating renditions for large volumes takes significant time unless suppressed, and indexing large migrations can take several hours.8
- Cutover. Veeva recommends migrating most data in batches while the legacy system is still running, then running a delta migration of changed data on the cutover weekend, and using user access control to hide batch-loaded content until cutover if the target Vault is already live.8
Sandbox Capacity Shapes the Test Plan
Veeva’s sandbox documentation sets size limits: a Small sandbox holds up to 100,000 object records and 10,000 document versions, and a Medium sandbox up to 1,000,000 object records and 100,000 document versions. Sandboxes that exceed their limits are blocked from creating new records or documents. Small sandboxes expire after 30 days of inactivity.13 Veeva’s best practices also recommend linking file staging to a Vault you do not plan to refresh during the migration, usually the environment where validation happens, so dry runs and validation testing can reuse staged files.8
Put those facts next to your document counts. If the legacy repository holds several hundred thousand document versions, only a Full sandbox or an add-on order will hold a full-volume validation run, and the development, test, and validation environments all compete for the same entitlement. Our article on environment strategy for validated systems covers how to plan those environments. The time to decide whether you need more sandboxes is before the order form is signed.
Overlay the Release Calendar
With three general releases a year and a prerelease window of about four weeks before each, a program that runs for a year or more will cross at least three of them. Each one brings a Release Impact Assessment to review, a prerelease window to test in, a week with configuration changes discouraged, and a weekend on which migrations should not run. Draw these on the project plan at the start. Then check that the planned go-live, the final validation run, and user acceptance testing do not collide with them. Using the proposed 26R3 dates, for example, a team that planned a production cutover for the weekend after December 4, 2026 would be scheduling against Veeva’s own guidance.28
A Sample Project Sequence
Before Signature
Content inventory with counts by type, migrate or archive decisions in principle, interface inventory, sandbox needs, migration ownership, and a draft release calendar overlay.
Design
Target configuration, reference data agreement, field and state mappings, and the migration specification with acceptance criteria.
Source Cleanup and Close-Out
Deduplication, picklist normalization, Person records for former staff, and a campaign to close in-flight records and document changes in the legacy system.
Build, Stage, and Dry Run
Preload files to staging, run dry runs on representative subsets, and measure throughput to replace estimates with observed timings.
Validation Run and UAT
Executed against the specification, outside release weeks, with deviations resolved before production.
Batch, Delta, and Cutover
Batch loads while the legacy system runs, a delta on cutover weekend, verification allowing for indexing delay, and a migration summary report.
Legacy Decommissioning
Archive retrieval tested, legacy audit trails stored and readable, records disposition signed off, and the legacy system retired under change control.
What to Settle in the Contract and Statement of Work
The questions above only help if their answers end up in documents that bind the parties. The table below lists items we suggest settling in the order form, the statement of work, or the quality agreement before signature. It does not replace legal review, and the right answer for each will depend on your applications, volumes, and risk profile.
| Item | Question to Settle | Why It Matters |
|---|---|---|
| Sandbox entitlement | How many sandboxes of which size, and is an add-on needed for a full-volume validation run? | Size limits block loads once exceeded; entitlements are per production Vault |
| Domains | Which Vaults belong to which domain, now and after any planned consolidation? | Standard Veeva Connections require a shared domain |
| Migration ownership | Customer, Veeva Migration Services, or a Certified Migration Partner, and who writes, runs, and verifies each step? | Annex 11 expects formal agreements that state each party’s responsibilities |
| Migration scope | Which content types, versions, audit trails, annotations, and signature pages are in scope, with counts? | Fixed-price work assumes a volume and a complexity; both need to be written down |
| Legacy audit trails and archive | Where legacy audit trails and archived records will live, and who proves they stay readable? | Vault cannot insert external events into its own audit trail |
| Validation deliverables | Which migration validation documents each party produces and approves | Validating the configured system and validating the migration are separate work |
| Release support | What help is included for release impact assessment and prerelease testing during and after the project? | Three general releases a year continue after the project team leaves |
| Integrations | Which interfaces are standard connections, which are custom, and who supports each after go-live? | Custom interfaces are yours to maintain through every release |
| Audit rights | How and when you can audit the vendor and any migration partner | Veeva says it hosts customer audits on request; partners need the same commitment |
| Exit and data return | In what formats, and with what metadata and audit history, content can be exported if you leave | Any future migration or system change will depend on it |
Sources for the table: sandbox entitlements and limits, domain structure, and connections are from Veeva’s help documentation;1213 migration options and audit trail limits are from Veeva’s migration guidance;78 audit hosting is from Veeva’s validation features brief;5 and the expectation for formal third-party agreements is from Annex 11.14 For a broader view of vendor evaluation in regulated settings, see our guide to selecting software vendors for GxP regulated industries.
A simple test before signature. Ask each party, separately, to describe who does what on cutover weekend: who runs the delta load, who verifies it, who signs the migration summary report, and who decides to roll back if verification fails. If the three answers do not match, the statement of work is not finished.
Conclusion
Veeva publishes detailed, practical migration and release guidance, and that guidance is the best argument for doing the planning early. It tells you that in-flight documents should not be migrated, that legacy audit trails cannot enter the Vault audit trail, that document loads run on a single thread, that migrations should not run the weekend after a general release, and that UAT or validation testing for each release belongs in a window of about four weeks. Every one of those facts has a consequence for scope, staffing, or schedule, and every one is easier to plan for before signature than after.
The six groups of questions in this article are not a reason to delay a decision. They are a way to make the decision with the work visible: what the data model needs, what the legacy estate holds, how the migration will be proven, what three releases a year will ask of the quality and IT teams, what connects to what, and whether the timeline fits the constraints. A team that can answer them in writing is ready to sign.
Sakara Digital works with pharma and biotech organizations planning document management, quality, and regulatory system changes, including Vault programs. If you are preparing for a Veeva Vault migration and want an independent perspective on scope, validation approach, or timeline before you commit, we are happy to have that conversation.
For Further Reading
For Further Reading
- Data Quality Regression Testing After System Migrations: A Practical Test Design
- Environment Strategy for Validated Systems: Dev, Test, Val, Prod, and the One You Forgot
- Beyond the SOP Index: Four Data Quality Pilots for Document Management
- Selecting Software Vendors for GxP Regulated Industries: A Practical Guide
References & Sources
- Veeva Systems. “About Veeva Vault Releases.” Veeva Vault Release Notes, accessed September 2026. https://rn.veevavault.help/en/gr/about-vault-releases/
- Veeva Systems. “About the 26R2 Release.” Veeva Vault Release Notes, accessed September 2026. https://rn.veevavault.help/en/gr/about-the-26r2-release/
- Veeva Systems. “Prerelease FAQ.” Veeva Vault Release Notes, last updated June 26, 2026. https://rn.veevavault.help/en/gr/pre-release-faq/
- Veeva Systems. “26R2 Release Impact Assessment” (Excel workbook). Veeva Vault Help, final update August 7, 2026. https://platform.veevavault.help/assets/downloads/ria/Vault-Release-Impact-Assessment-26R2.xlsx
- Veeva Systems. “Veeva Vault Validation Features Brief.” Veeva, accessed September 2026. https://www.veeva.com/resources/veeva-vault-validation-product-brief/
- Smith S, Chuk J, O’Brien K, Gassmen C, et al. “A Risk-based Approach to Change Management of Validated GxP Systems.” A Veeva Quality Community White Paper. https://www.veeva.com/wp-content/uploads/2021/01/NA_Whitepaper-_Risk-based_Approach_to_Change_Management_of_Validated_GxP_Systems.pdf
- Veeva Systems. “Vault Migrations Overview.” Vault Developer Portal, accessed September 2026. https://general.veevavault.dev/migrations/overview
- Veeva Systems. “Migration Best Practices.” Vault Developer Portal, accessed September 2026. https://general.veevavault.dev/migrations/references/migration-best-practices/
- Veeva Systems. “Data Transformation Considerations.” Vault Developer Portal, accessed September 2026. https://general.veevavault.dev/migrations/references/data-transformation/
- Veeva Systems. “Migrating Data to Veeva QualityDocs.” Vault Developer Portal, accessed September 2026. https://general.veevavault.dev/quality/migrations/guides/quality-migrations/quality-docs
- Veeva Systems. “Migrating Data to Veeva QMS.” Vault Developer Portal, accessed September 2026. https://general.veevavault.dev/quality/migrations/guides/quality-migrations/qms
- Veeva Systems. “About Veeva Connections.” Veeva Vault Help, General Release 26R2, accessed September 2026. https://platform.veevavault.help/en/gr/533581/
- Veeva Systems. “Administering Sandbox Vaults.” Veeva Vault Help, General Release 26R2, accessed September 2026. https://platform.veevavault.help/en/gr/48988/
- Pharmaceutical Inspection Co-operation Scheme. “PIC/S Guide to Good Manufacturing Practice for Medicinal Products, Annexes (PE 009-17),” Annex 11: Computerised Systems, in effect August 25, 2023 (copy hosted by ECA Academy). https://www.gmp-compliance.org/files/guidemgr/pe-009-17-gmp-guide-xannexes.pdf
- ISPE. “GAMP Guide: Records & Data Integrity.” International Society for Pharmaceutical Engineering, published March 2017. https://ispe.org/publications/guidance-documents/gamp-records-pharmaceutical-data-integrity
- DIA RIM Reference Model Working Group. “DIA Regulatory Information Management Reference Model V2.0 User Guide.” DIA, 2026. https://www.diaglobal.org/en/-/media/diaglobal/files/resources/tools-and-downloads/rim-reference-model-user-guide.pdf
- Benitez J, An A, Santos AB, et al. “Data migration, validation and implementation of a new laboratory information system (LIS) in an academic pathology department, using Ellkay data archive, and Epic Beaker anatomic and clinical pathology modules.” Journal of Pathology Informatics, 2025. https://pmc.ncbi.nlm.nih.gov/articles/PMC12332207/








Your perspective matters—join the conversation.