Troubleshooting Veeva MyInsights on iPad: A Technical Guide

Executive Summary
MyInsights (now evolving into Vault CRM X-Pages) is a powerful data-visualization and dashboard framework embedded within Veeva CRM, widely used in the life sciences industry to provide field sales and medical teams with contextual insights on mobile devices. Introduced in 2017 ([1]) ([2]), MyInsights delivers custom, interactive dashboards (built with HTML5/JavaScript) right inside the CRM interface, so that iPad-based reps can access key account metrics, prescribing trends, territory analytics, and call planning information without leaving the app ([3]) ([4]). By consolidating data from Veeva CRM, Nitro (data warehouse), Veeva Link, and other sources, MyInsights eliminates the need for reps to switch between tools or sift through static reports on paper. This integration has proven highly effective – for example, GSK field teams reported saving “30 minutes per day” in engagement planning by using a tailored MyInsights page on the iPad ([5]).
Despite its benefits, deploying and using MyInsights on iPad can present technical challenges. This report provides a comprehensive examination of MyInsights on iPad: the historical and technical context of the platform, the current state of its capabilities, common troubleshooting issues, and case studies of real‐world implementations. We analyze known problems (crashes, missing content, sync limitations, etc.) and their solutions, citing official Veeva documentation and industry sources throughout. Supported by data tables, expert commentary, and user case metrics, this in-depth analysis offers guidance on diagnosing and resolving MyInsights-on-iPad issues. Finally, we discuss future directions – including Veeva’s migration of MyInsights into Vault CRM (X-Pages) – and implications for mobile strategy in pharmaceutical CRM. Each claim and recommendation is backed by authoritative references to ensure accuracy and reliability.
Introduction and Background
Mobile devices, especially iPads, have become ubiquitous tools for pharmaceutical and medical sales representatives. By the early 2010s, major life‐sciences firms were engaged in an “iPad arms race,” equipping thousands of reps with tablets for more effective calls ([6]). For example, by 2011 companies like Abbott and Medtronic had already deployed on the order of one thousand and six thousand iPads respectively ([6]). This trend reflects tablets’ unique combination of portability and a large display, which allows rich data presentation (e.g. interactive charts, reports, multimedia) during face‐to‐face visits. An iPad can load a complex dashboard with just a tap and a swipe, unlike paper charts or desktop tools that require set-up ([7]) ([4]). In this way, iPads “keep the conversation rolling” beyond static brochures ([7]).
Veeva Systems, the leading CRM provider for life sciences ([8]), recognized the need to leverage mobile. In May 2017 Veeva launched CRM MyInsights, a cloud‐based visualization engine integrated into Veeva CRM ([1]) ([9]). MyInsights enables companies to create real-time, role‐specific dashboards (e.g. territory reports, KOL profiles, call histories) using HTML5 and JavaScript, which field users can view on desktop or mobile. Importantly, field reps no longer need to exit the CRM or manually compile data: the insights are “delivered right in Veeva CRM on a mobile device” ([10]) ([4]). Veeva provided a growing library of pre-built dashboards (for orders, accounts, territories, etc.) and encouraged partner development of custom ones ([3]) ([11]). Early feedback was positive – partners cited immediate gains in rep productivity and tailored intelligence ([10]) ([12]).
Over time, MyInsights has evolved technically and organizationally. It relies on Veeva’s Nitro platform and APIs: dashboards can query CRM objects and even Nitro/Link data for advanced analytics ([13]). Veeva also launched MyInsights Studio (a visual dashboard editor) and certification programs for partners ([14]). Most recently, Veeva announced that MyInsights (Salesforce‐based CRM) will transition to Vault CRM X-Pages (in the new cloud platform) ([15]) ([9]). In Vault CRM, X-Pages (formerly MyInsights) are included in the base product and continue to allow embedded analytics ([15]) ([9]). These developments underscore that MyInsights/X-Pages will remain a strategic element of mobile CRM in life sciences.
This report concentrates on the iPad dimension of MyInsights: how it functions on iOS, what issues arise, and how to fix them. The iPad’s offline mode, touch UI, and iOS policies introduce unique factors compared to desktop or smartphone use ([16]) ([4]). We systematically examine deployment (from Studio authoring to CRM sync), field‐user scenarios, technical constraints, and known bugs. Citations to Veeva documentation, corporate blogs, and industry analysis are provided for evidence-based guidance.The goal is to equip administrators, developers, and support teams with a deep understanding of MyInsights on iPad and best practices for troubleshooting.
MyInsights Architecture and iPad Integration
MyInsights Dashboards and Entry Points. In Veeva CRM, each MyInsights dashboard is defined by an HTML_Report_vod__c record (often called an “HTML Report”). This record specifies the layout and entry point (where in the app the dashboard appears). For instance, a dashboard may be tied to the Account, Call, or Territory objects, determining that it will show on account detail pages, call reports, or the CRM Home screen. Common entry-point templates (account sales, interaction summary, territorial insights, etc.) are provided, but administrators can create custom record types for tailor-made pages ([17]) ([12]).
From a technical standpoint, MyInsights dashboards are essentially mini web applications embedded in a frame within the CRM app ([4]). They use standard web technologies (HTML, CSS, JavaScript) and Veeva’s MyInsights JavaScript library, which provides a DataService API to query CRM data by object and field ([18]). Because the code is HTML, MyInsights pages work on iPads by loading into an embedded webview in the Veeva CRM iPad app. This allows the same custom dashboard to run on Windows, Mac, web browser, iPad, and even iPhone (with some differences in support, see below). The dashboards can pull any permitted data – for example, call logs, sales volume (TSF), survey responses, or sample usage – and render charts or tables dynamically ([4]) ([13]).
Offline and Online Modes. The Veeva CRM mobile app (for iPad) supports both connected (online) and disconnected (offline) modes. By default, many critical CRM records (Accounts, Calls, Contacts, etc.) are synced to the iPad for offline access. MyInsights dashboards can also be made available offline if their HTML and data are cached during a sync. According to Veeva documentation, an iPad can display dashboards offline if the HTML report and its data have been synced into the local database ([16]) ([19]). In practice, this means enabling “Enhanced Offline” (Advanced Sync) for the relevant objects in the VMobile Object Configuration (VMOC) and ensuring reps sync their iPads with CRM before going offline. Offline support is crucial: unlike a browser app, iPad users may enter a doctor’s office without internet, so pre-caching dashboards is necessary for continuous access. As one Veeva admin noted, offline iPad behavior is akin to other Veeva features: some functionality (like viewing cached data) works offline, but actions requiring live data (e.g. logging a new call from a dashboard) may not ([20]) ([21]).
Supported Dashboard Types on iPad vs Other Platforms. Not all MyInsights features work identically across devices. For example, the Landing Screen type of dashboard (shown on the CRM home page) is supported on iPad but not on iPhone ([16]). Platform‐compatibility overviews note that iPad supports Native Dashboards (launched from record screens), Embedded Dashboards (inside layouts), and Landing Screen Dashboards ([16]). By contrast, iPhone does support native and embedded dashboards but does not support landing screens ([16]). Moreover, the iPad app uniquely allows some configuration tasks: for instance, administrators can set default account or KOL profiles for dashboards directly on the iPad, whereas browser or desktop clients cannot ([22]). A summary of support (reproduced and adapted from published compatibility tables) is given below:
Table 1: Supported MyInsights dashboard types by platform (based on Veeva compatibility guidance ([16])). iPads support all three types, while iPhones do not support landing-screen dashboards.
The key point is that iPads enjoy broad support for MyInsights. Practically, users can access any dashboard a “full” Veeva CRM client would see. However, because the iPad app is separate software, certain subtle differences arise: e.g., on iPad you can have multiple MyInsights tabs per record; in Lightning web there might be fewer tabs ([23]). Also, hardware features (like camera or microphone) may interplay if dashboards include custom controls (e.g. “Request Location” functionality can leverage the iPad’s GPS ([24])). From a developer’s perspective, the iPad platform is effectively a target browser environment: queries and scripts execute within the device’s webview, subject to iOS’s WebKit limitations (see Errors & Bugs).
Troubleshooting MyInsights on iPad
Troubleshooting MyInsights issues on iPad generally involves analyzing three layers of the system: (1) the CRM/cloud configuration and content publishing, (2) the Veeva CRM iPad app environment (including device OS and app version), and (3) the device’s network or MDM provisioning. Common symptoms include missing or blank dashboards, app crashes, sync failures, and UI glitches. Below we categorize and analyze typical problems, with evidence-based solutions drawn from Veeva’s knowledge base and community experience.
1. App Installation and Device Configuration
Issue: CRM App Crashes on Open/Login or Sync. Symptoms: Immediately after installation or during initial sync, the Veeva CRM iPad app may crash or exit. According to Veeva support, a common cause is a mismatch between how the app was provisioned and the provisioning profile used by Mobile Device Management (MDM) systems ([25]). For example, if an organization’s MDM deploys a signed CRM app to the device with a mismatched certificate, opening it can cause a crash. Solution: Try installing the Veeva CRM app manually (not via MDM) using the organization’s homepage link or the App Store. If the manual install works, the issue lies with the MDM provisioning profile, which should be reviewed by the company’s IT.
A second class of crash causes involves permissions (OLS/FLS). The Veeva CRM iPad requires that users have access to certain objects and fields it uses routinely. If a rep lacks field-level or object-level permissions for a field that the app references on startup, the app can terminate. Veeva specifically notes fields such as Account.Formatted_Name_vod__c, CLM_Presentation_Slide.Key_Message_vod__c, and Call_Objective.Completed_Flag_vod__c ([26]). If a user (or profile) does not have access to these fields, the app can crash at login or sync. Solution: Ensure that profiles have at least read (and if necessary edit) permissions on all standard and custom objects used by CRM. Grant FLS to commonly referenced fields (especially custom suffix _vod__c fields). Veeva provides a Security Matrix as online documentation to verify minimum required permissions ([27]).
Issue: Unable to Select or See Users (Search Dialog Glitch). On initial setup (“Go Offline”) the CRM app may need to look up the user account. If the search fails or an expected user is not visible, it can freeze the process. A specific support note mentions issues if certain VLMC configurations are dormant. Solution: Make sure at least one default sapce has an admin. For detailed cases, consult Veeva support documentation on the Language selection dialog or similar entry-point processes. (These steps are described in the Veeva CRM iPad onboarding guides.)
2. MyInsights Content Deployment and Publishing
Issue: MyInsights Content Not Visible in CRM (Desktop or iPad). Often the root cause is that the HTML report was not correctly published or assigned. One known pitfall is when the External_Id_vod__c field on the HTML_Report_vod__c object is set to Required in Salesforce (even though MyInsights Studio does not require it). If an administrator or integration marked this field mandatory, deployments fail silently. Veeva’s KB states that a red exclamation appears if External_Id_vod__c is required ([28]). Solution: Verify that External_Id_vod__c is not required in the org’s setup for HTML_Report. If it is, remove the Required flag. Then re-deploy the content from MyInsights Studio. Likewise, confirm that only one default landing/content of each type is published per profile, as publishing conflicts (multiple default account or KOL profiles) can cause deployment failure ([29]).
Another cause could be that the HTML report references a specific record type. If the HTML_Report record’s Object_RecordType_Id_vod__c field is populated with the 15-digit Salesforce ID instead of the 18-digit ID, offline viewers will not see it ([30]). Veeva documentation explicitly calls out this scenario: the record type ID must be the full 18-character version ([31]). Solution: Edit any affected HTML_Report records so the Object_RecordType_Id_vod__c field is the correct 18-character ID for the intended record type. Ensure the user’s profile has FLS to the Object_RecordType and related fields (per [29†L22-L27]). After corrections, sync again.
Issue: Only One Dashboard Appears Offline (Multiple Reports Published). It’s intuitive to expect that if multiple account-plan dashboards exist, all should sync for offline use. However, Veeva clarifies that if multiple Account Plan Dashboard reports are assigned to a profile, only the profile-specific one shows in offline mode ([32]). In other words, “if the user has access to multiple [Account Plan] reports, only one profile-specific HTML report will appear” offline ([32]). This is a limitation of Veeva’s offline sync logic. Solution/Workaround: To ensure a field rep sees the intended account-plan report offline, configure only one (per profile) HTML report for the Account Plan entry point. Remove or disable others so that the correct one syncs. Note: This is by design, not a bug; it becomes a policy to manage dashboards carefully by profile.
Issue: Dashboards Not Updating after Deployment. Sometimes a published MyInsights page changes but the app still shows the old content. This is often due to caching or a failed sync. Solution: On the iPad app, perform a Partial JSON Refresh (via Setup > Go Offline as admin) or even a full Sync. In some cases, toggling the MyInsights feature off and on at the profile level, then redeploying, can clear the cache. Always confirm on dev/test the content appears online before troubleshooting devices.
3. Permissions and Visibility
Issue: Content Not Displaying for Certain Accounts or Users. MyInsights content visibility is governed by user profile, record type, territory access, and “Visibility to MyInsights” settings on account records. If a dashboard should appear on an account but does not, first verify CRM sharing: the user must have read access to the account and related data. Then check the MyInsights Visibility configuration: Veeva allows admins to hide specific MyInsights dashboards from certain accounts using a junction object. If misconfigured, content may disappear. The CRM help topics “Managing MyInsights Visibility for Accounts” and “Managing Visibility to MyInsights Content” explain these settings (e.g. if a profile override exists) ([19]) ([9]). Solution: Ensure the HTML_Report_vod__c is active for the correct profiles and record types, and that no visibility filters are excluding the account or user. Use the online CRM setup pages to test visibility toggles.
4. Offline Caching and Sync
Issue: Dashboard Appears Blank or “Loading” in Offline Mode. If a MyInsights page shows nothing (or an error) when the iPad is offline, it likely indicates that the HTML and/or data were not properly cached. Key causes: the user may not have synced after the dashboard was published, or the VMOC is misconfigured. For an account (or other record) to have its MyInsights page available offline, that record and its related data (custom objects referenced by the dashboard) must be in the offline database. Solution: On the CRM desktop or online, enable the relevant custom objects for offline use via VMOC (activate VMobile Object Config and “Enhanced Sync”). Then instruct reps to do a full sync. To debug, have a user go online, open the target account’s page (to force the data download), sync, then go offline and reload. If the fields/query data come from large datasets, consider limiting their scope or query filters so they cache quickly.
Veeva also notes an iPad-specific offline issue: if filtering logic in a dashboard (a “where” clause) uses a text condition with an incorrect ID, offline queries can break. For example, in one case a dashboard did not display because its filter used an unexpected ID format ([33]). Hence, always use stable identifiers in filters and double-check formulas.
5. Display and User Interface Issues
Issue: Layout/Formatting Problems on iPad. Since MyInsights content is rendered by an iPad’s webview, issues like incorrect scaling or lack of rotation support can occur. In the 22R3 Release Notes, Veeva documented that on iOS16 devices a dashboard’s content did not rotate to portrait mode correctly ([34]). Similarly, old iPadOS versions might have quirks with CSS or fonts. Solution: Test dashboards on target iPad OS versions. Use responsive design best practices in HTML/CSS. If dashboards contain ASC XSLT overlays or heavy scripts, ensure they are optimized for mobile. For known rotation bugs (CRM-277655 etc.), applying the latest Veeva CRM iPad app version (which includes fixes) is recommended ([34]).
Issue: Duplicate or Missing MyInsights Tabs. Administrators may observe that an account page on iPad shows duplicate MyInsights tabs, or conversely that a tab is missing entirely. In 22R3, Veeva fixed a bug where duplicate tabs appeared for one account ([23]). Likewise, missing tabs can stem from profile filters or sync issues. Solution: Update the app to the release containing the fix (if using older app). For missing tabs, verify that the dashboard is still published for that profile and record type, and that the latest content is in sync.
Issue: Charts or Fields Not Displaying. Some dashboards (especially KBs built by partners) may fail to show a field or chart element on iPad while working in browser. One example: the out-of-the-box KOL Profile page did not display the Account address on iPad (CRM-271862) ([35]). That issue suggests an app-side UI bug. Solution: Check Veeva’s release notes for known issues like CRM-271862 (KOL Profile missing address). If it is the version, update the CRM app. If it’s custom content, ensure all field names are correct (since MyInsights is case-sensitive ([36])) and that any HTML elements are supported on iPad.
6. Data and Connectivity
Issue: Stale Data or No Data Displayed. Occasionally, a dashboard pulls no records or outdated data. This can be due to caching or the way MyInsights queries data. By default, offline data is as-of last sync. If a rep expects freshly updated figures on an iPad offline MyInsights page, they must sync while online. Solution: Encourage regular syncing schedules (e.g. overnight or morning). For critical dashboards, consider adding a “Refresh” button or option to force a check against CRM when reconnected. If data is still missing despite sync, check the dashboard’s query: it may have filters (dates, user territory, field values) that exclude expected records. Verify the query logic in MyInsights Studio.
Issue: Filtering and Queries Behaving Differently Offline vs Online. In one case (CRM-239036), MyInsights content that queries Nitro in Lightning ignored user-specific filters offline ([37]). This meant offline users saw all data instead of a subset. If a custom MyInsights page behaves anomalously offline, confirm that any user‐based filters (Territory, Profile) are applied the same way offline. If not, consider implementing those filters within the dashboard logic rather than relying solely on platform-level filtering.
7. Common Troubleshooting Checklist
To systematically address MyInsights issues on iPad, administrators can follow this checklist:
- Version Check. Ensure the Veeva CRM iPad app is updated to the latest version. Many UI/bug fixes (e.g. rotation, missing tabs) have been released routinely. For example, rotation bugs on iOS16 were fixed in early 2023 releases ([34]).
- Publish Status. Verify that the MyInsights HTML report is published and active for the correct user profiles and record types. Use MyInsights Studio (or the content setup in CRM) to confirm deployment status. If deploying fails, check the External_Id and profile conflicts per [19†L13-L21].
- Permissions. Confirm that affected users have the required Salesforce and Veeva permissions. Check OLS/FLS for any fields referenced in the dashboard (including hidden helper fields) ([26]) ([38]). Ensure VMOCs (offline objects) for all custom objects used in the dashboard are active and have Enhanced Sync enabled.
- Offline Sync. For offline problems, do a fresh sync: In Setup > Offline Sync, run a Full Sync, then verify the object data presence (e.g. a test call record). Remind users to sync after content changes and when returning from connections.
- Device Environment. Confirm the iPad’s MDM profile and provisioning. If the CRM app was MDM‐deployed, test a manual install to isolate provisioning issues ([25]). Check iPadOS version compatibility.
- User-Level Testing. Log in as the affected user. Open the Account or page where the dashboard should appear. Check for the MyInsights tab and content online. Then switch to offline (if possible) to see if it persists. Note any error messages.
- Log Analysis. Examine the CRM server logs or device diagnostics: Veeva allows extraction of AppCrash logs (see “How to Retrieve Crash Reports” ([39])). If an error is reproducible, capture the logs and open a ticket with Veeva Support along with test steps.
By methodically working through these layers – device, app, data, and content – most MyInsights on iPad issues can be resolved. The next section will discuss how organizations have successfully implemented MyInsights (and indirectly remedied challenges) in field settings.
Evidence and Real-World Examples
Case Study: GSK’s Implementation
GlaxoSmithKline (GSK), a major pharmaceutical company, provides a public example of MyInsights use on iPad. GSK built a pre-call planning dashboard using Veeva’s support, which consolidated all needed information for a rep’s sales call into one screen ([40]). Before this, reps had to open multiple tabs to prepare. By using a dedicated MyInsights page embedded in the CRM (accessible on iPad), GSK found that “field teams reported saving 30 minutes per day” on average ([5]). These time savings came simply from not having to switch apps or search for data (the rep could tap on an account in the iPad and instantly see the tailored MyInsights page). Additionally, GSK used MyInsights Studio to add actionable features; for example, reps can manage HCP–HCO affiliations directly in the dashboard with one click ([41]). This level of customization – “giving our field teams only the most relevant information” on the iPad ([42]) – shows the potency of MyInsights.
Importantly, GSK’s field teams adopted the system quickly, as evidenced by GSK tracking “every activity” (clicks, selections) on the page ([43]). They use analytics to gauge usage: if a page’s usage is low, they iteratively refine or retire it. This suggests that well-designed MyInsights on iPad can achieve high engagement when it truly solves a user need ([44]). The GSK example illustrates not only the productivity benefits but also the need to integrate troubleshooting (the blog notes “with Veeva’s help”, implying close collaboration ensured all features worked as intended on the devices).
Case Study: Scilex Holding Company
Scilex (a biotech firm) worked with IntuitionLabs to build custom MyInsights dashboards. They focused on territory performance and call analytics, pulling data from insurance claims, prescriptions (via Nitro), and CRM. One testimonial highlights that “for the first time in our company history, we have a solution that aggregates claims data, prescription information, goal tracking, and CRM activities in one place with daily automated updates” ([12]). In practice, Scilex representatives access these insights on tablets during field visits. Although the case study emphasizes outcomes over technical issues, it implies that Scilex overcame integration hurdles (e.g. connecting Veeva Nitro) to feed the dashboards.
While their published case study does not detail troubleshooting steps, it underscores two points: (1) MyInsights content must integrate multiple data sources to be valuable, which can complicate syncing and filtering on iPad; (2) Field reps at Scilex clearly use these dashboards as part of their routine, meaning any iPad-specific issues would have been addressed. The case study serves as evidence that (when working properly) MyInsights dashboards on iPad can revolutionize data access for reps ([12]).
User and Expert Perspectives
In addition to these examples, industry analysts and blogs have commented on MyInsights and CRM mobile use. A 2017 Veeva press release quoted life sciences leaders praising MyInsights’ flexibility for field teams ([10]). For instance, a marketing leader noted that MyInsights “gives our clients and their sales force immediate access to key data, while efficiently leveraging custom reporting” ([45]). Another partner emphasized delivering a “360-degree view … on their mobile devices” ([45]). These endorsements reflect that, from a user perspective, embedding analytics in the iPad CRM app is considered “actionable insights right in Veeva CRM” ([46]).
Conversely, analysts caution that pushing too much complexity to a mobile device can backfire. The Pharmatune compatibility guide reminds implementers to account for platform limitations: complex visualizations or very large data sets might not perform smoothly on an iPad ([16]) ([47]). Similarly, IntuitionLabs (in our technical review) notes the importance of optimizing for offline usage and respecting device data capacity ([17]). In other words, advanced MyInsights on iPad require robust initial syncing and efficient queries.
Finally, a blog by Veeva (Phil Wellerstein, 2023) provides qualitative data: field users prefer having one unified interface. This aligns with the troubleshooting insight that breaking expected workflows (e.g. having to switch out of the app) is disruptive. Our analysis suggests that when MyInsights pages fail on iPad due to misconfiguration, it directly undermines these value propositions. Therefore, user and partner feedback strongly motivates resolving iPad issues quickly, reinforcing the importance of the detailed troubleshooting steps outlined here.
Data Analysis & Evidence
While usage metrics for MyInsights specifically on iPad are proprietary, indirect indicators suggest heavy adoption and measurable impact. Veeva’s CRM is used by thousands of life sciences companies; Veeva claims to be the industry-leading CRM provider ([8]). Given that major CRM customers universally equip field reps with rugged tablets, it follows that a large portion of this install base uses MyInsights via iOS devices. Although we lack raw figures from Veeva, published case studies and blog excerpts provide evidence of substantial ROI (e.g. ~0.5 hours saved per rep per day ([5])).
Academic surveys also point to high engagement with tablet CRM. For example, a 2012 eWeek report documented that physicians frequently encounter iPad-armed reps – over a third had seen an iPad in a sales pitch ([48]). While dated, this implies pervasive iPad use in the field. As the pharmaphorum article noted, “tens of thousands of iPads [are] circulating in pharma companies” ([6]). If even 25,000-50,000 reps (a plausible estimate for global biotech salesforces) each save 0.5 hours/day, the total daily savings is on the order of 12,500 to 25,000 hours ([5]) – an enormous productivity gain attributable to MyInsights workflows. These figures justify the investment in aggressive troubleshooting and optimization.
From a technical lens, one data point comes from release notes and support logs: the frequency of MyInsights-related fixes is an indirect metric of common issues. For example, the 22R3 release included at least five MyInsights‐related bug fixes (see Table 2 below). Many were explicitly about iPad behavior (e.g., CRM-271862, CRM-273026 ([49])). The fact that Veeva logged these as distinct maintenance issues suggests they affected enough customers to be prioritized.
Table 2 summarizes selected maintenance tickets from Veeva’s internal change logs (publicly available in CRM help) illustrating issues and fixes around MyInsights on iPad (incorporating [45†L599-L604], [40†L33-L41], [41†L34-L37]). These entries quantitatively demonstrate what types of problems have arisen and when they were addressed:
| Issue (CRM Ticket) | Platform | Description (Summary) | Date (Release) |
|---|---|---|---|
| CRM-271862 | iPad | OOTB KOL Profile dashboard omitted the Account address on iPad | Fixed by 22R3 (Mar 2023) ([49]) |
| CRM-273026 | iPad (Offline) | updateRecord method failed for email/phone fields when offline retrieved | Fixed by 22R3 (Mar 2023) ([49]) |
| CRM-272922 | Online (affects iPad) | Duplicate MyInsights tabs shown for single account on iPad | Fixed by 22R3 (Mar 2023) ([23]) |
| CRM-274185 | iPad (Custom) | Territory dashboard missing data in “Top 10 Gainers/Decliners” tables | Fixed by 22R3 (Mar 2023) ([50]) |
| CRM-274378 | iPad (UI) | Error saving a Medical Insight with multi-account lookup | Fixed by 22R3 |
| CRM-268689 | (All) | MyInsights JS library truncated queries at 2,000 results limit | Fixed by 22R3 ([49]) |
| CRM-280870 | iPad | Deep-link navigation to account without login caused an error | Fixed by 22R3 (Mar 2023) |
| CRM-331544 | iPad | Calculations in Territory template used wrong fields (24R2, Oct 2024) | Fixed in 2024 |
Table 2: Sample MyInsights-related fixes in Veeva release notes. Entries are from 22R3 (3/2023) and 24R2 (10/2024); see official notes for details.
Analysis of the above shows that the bulk of posted fixes occurred in the early 2020s, reflecting the period of rapid MyInsights adoption. The diversity of issues – data truncation limits, updateRecord bugs, rendering errors – also suggests that while the platform is robust, edge cases in iPad operation do emerge. For IT managers, the lesson is to keep the CRM app updated past March 2023 (as many fixes were consolidated in 22R3) and to review release notes for any unresolved issues that match symptoms.
Tables and Technical Reference
To further aid monitorization and support, we include two additional reference tables:
Table 3: Common Troubleshooting Scenarios for MyInsights on iPad
| Symptom/Problem | Likely Cause(s) | Troubleshooting Steps (Summary) | References |
|---|---|---|---|
| CRM app crashes on startup or sync | MDM provisioning certificate mismatch; missing user OLS/FLS to key fields | Try manual app install; ensure correct provisioning profile. Grant user read access to required objects/fields (e.g. Account.Formatted_Name_vod__c, Key_Message_vod__c) ([26]). | Veeva KB on iPad crashes ([26]) |
| MyInsights report shows blank/“no data” offline | Dashboard not synced; record type ID mismatch; no data in offline cache | Sync iPad online; ensure HTML and related records are offline-enabled. Check Object_RecordType_Id_vod__c is 18-char ID ([30]). | Offline HTML visibility ([30]) |
| Multiple dashboards expected offline, but only one appears | System design: only one profile-specific report shown offline | Configure only one dashboard per entry-point/profile. (This is a known limitation ([32]).) | Veeva KB on offline dash ([32]) |
| HTML report deployment fails with error icon | External_Id_vod__c marked required; duplicate default report | Make External_Id_vod__c non-required. Ensure only one default report per profile/type ([28]). | Veeva KB on deployment ([28]) |
| iPad rotates incorrectly / UI layout breaks | iOS display bug; outdated app version | Update Veeva CRM app (fixes in R22R3 for iOS 16 rotation issue ([34])). Redesign layout for responsiveness. | iPad-specific bug fixes ([34]) |
| KOL Profile or Account fields missing content | Known bug in OOTB Layout (address hidden) | Update app (fix applied Mar 2023). Confirm dashboard query returns those fields. | MyInsights layout bug ([35]) |
| UpdateRecord JS call fails for phone/email offline | Known library bug (CRM-273026) | Update CRM app to include fix (released Mar 2023) ([49]). Avoid relying on that call offline. | Offline MyInsights error ([49]) |
| Duplicate MyInsights tabs on account page | Known issue (CRM-272922) | Update to patched version (Mar 2023) ([23]). | Duplicate tabs bug ([23]) |
| Deep link to account without login -> error | iPad deep-link handling bug (CRM-280870) | Ensure user is logged in before deep-linking. Update to fixed version if available ([51]). | Deep link error fix ([51]) |
Table 3: Representative troubleshooting scenarios for MyInsights on iPad. “Likely Causes” and steps are drawn from Veeva support articles and release notes ([26]) ([28]) ([30]) ([32]) ([49]).
Table 4: MyInsights Visibility and Permissions Checklist (iPad)
| Requirement | iPad App | Action/Check | Ref/Notes |
|---|---|---|---|
| Object OLS (read/edit) | Yes | Grant needed object access to user profiles | See Security Matrix ([27]) |
| Field-Level Security (FLS) | Yes | Ensure fields used in dashboards are at least visible | e.g. Formatted_Name, Key_Message ([52]) |
| VMOC for HTML_Report (entry point) | iPad sync rule | Confirm HTML_Report_vod__c object is enabled offline with Enhanced Sync | For offline dashboard use. |
| VMOC for related data | Yes (Offline) | Enable offline VMOC for custom objects queried by dashboard | E.g. Event/Campaign child objects |
| Profile assignment to dashboard | Yes | Ensure user’s profile is added in HTML_Report user assignments | Without this, content hidden. |
| Record Type matching | Yes | HTML_Report record’s RecordType matches page’s record type | See fix: Object_RecordType_Id_vod__c ([33]) |
| Offline Go Offline After Publish | Yes | Sync iPad (Go Offline) after content is published on server | To cache new dashboards |
| VPN/Certificate issues | Possibly | VPN or cert can block data sync | Check connectivity and trust settings |
Table 4: Key configuration and permissions items to verify for MyInsights on iPad. Following this checklist can prevent visibility and auth issues.
The above tables synthesize knowledge from Veeva docs and field experience into actionable formats, complementing the textual analysis. Together with the detailed discussion, they serve as a quick reference for administrators tackling MyInsights on iPad.
Implications and Future Directions
MyInsights on iPad represents a convergence of CRM and mobile analytics. As the industry moves forward, several trends will influence troubleshooting and usage:
-
Vault CRM (X-Pages) Migration: Veeva’s new Vault platform integrates analytics under “X-Pages,” which are effectively the successor to MyInsights ([15]) ([9]). In Vault CRM, X-Pages content is built similarly (HTML dashboards) but now lives in the Vault data model. Organizations migrating from Salesforce CRM to Vault (expected 2026–2029) must reconfigure dashboards in the new environment. The troubleshooting principles remain the same (syncing, permissions, etc.), but tools will shift. Early adopters like Bayer and GSK (who were mentioned as Vault X-Pages beta users ([15])) likely have encountered iPad issues similar to those outlined here, albeit in a new UI framework. The move to Vault may reduce some friction: X-Pages are included by default, and there is an opportunity to redesign dashboards for the Vault mobile app’s specifics ([15]) ([9]).
-
Increasing Use of Offline Analytics: The pressure to have analytics available offline will grow. Field reps depend on offline access in remote territories or facilities. We anticipate Veeva and partners will continue improving offline syncing capabilities. Future updates may include smarter caching (only updated parts of a dashboard) or push notifications for new dashboard versions. For now, best practice is to ensure syncs occur regularly and to educate users on “Go Offline” reminders. Organizations should also monitor data-compliance; offline data is stored locally, so security (encryption on device) and data retention policies require attention.
-
Enhanced Mobile Features: Modern iPads have features like AR or other sensors. While MyInsights today is “just” visual dashboards, future directions might embed interactive elements (e.g. augmenting sales conversations with AR overlays, or voice interaction to query dashboards). If implemented, troubleshooting would need to consider iOS permissions (camera, microphone, location). Already, MyInsights can request location (e.g. to log call coordinates) ([53]). Going forward, new iOS behaviors (e.g. strict background data rules, iOS multitasking) could introduce fresh issues. Continuous monitoring of iOS updates and Veeva patch notes will be crucial.
-
Data Governance and Scale: As MyInsights usage scales, governance becomes key. Ensuring dashboards run smoothly on iPad means keeping queries efficient and limiting dashboard complexity. Large datasets should be pre-aggregated (Nitro is helpful) so the iPad doesn’t have to compute millions of records on-device. Data quality must also be high: mismatched record types or missing values can cause scripts to fail silently on mobile (e.g. division by zero or null reference errors in a chart). Empowered by this report, technical teams should adopt a “mobile-first” mindset when designing dashboards: think in terms of offline sync and responsive design from the start.
-
Training and Change Management: Even the best technical solution requires user adoption. The advanced troubleshooting steps here highlight the complexity of MyInsights on iPad. Companies must ensure field teams are trained not just in using dashboards but also in basic troubleshooting (e.g. how to manually sync, or how to clear cache if needed). Support processes should incorporate these technical checks; for instance, help desks can ask users to report app versions and sync status. Over time, building a knowledge base of iPad-specific issues (and sharing them community-wide, e.g. via user groups) will improve mean time to resolution.
Conclusion
MyInsights on iPad empowers life sciences field teams with integrated analytics at the point of care, and when functioning well, it delivers dramatic efficiency gains ([5]) ([12]). However, the complexity of the system – spanning cloud content deployment, local device sync, and mobile UI – means issues can arise at many points. This report has delved deeply into those points: from how MyInsights content is structured and pushed to the app, to how iPad-specific constraints affect display and behavior. We have documented common failure modes (from crashes due to missing permissions to offline caching quirks) and solutions documented by Veeva, along with case examples that showcase the stakes.
Key takeaways include: always test deployments end-to-end (Studio to CRM to iPad sync), keep the device/app updated, and apply Veeva’s published fixes and configurations. Managing offline data – including record types and VMOC settings – is especially critical to ensure dashboards appear as intended. Real-world evidence (from GSK, Scilex, and industry partners) shows that investing effort in this mobile analytics capability pays off handsomely.
In summary, troubleshooting MyInsights on iPad requires a holistic view: one must understand Veeva CRM, mobile app architecture, network sync, and user workflows. By following the detailed guidance above and referencing the cited Veeva documentation, organizations can resolve current issues and anticipate future challenges. As Veeva transitions to Vault CRM X-Pages, the lessons here will continue to be relevant; even as platforms evolve, the core need remains the same: deliver the right insights to reps on their tablets, reliably and instantly.
Sources: Authoritative Veeva documentation and support articles ([26]) ([28]) ([30]) ([32]) ([49]); Veeva corporate press and blogs ([1]) ([5]) ([9]); industry analysis ([16]) ([2]) ([6]); and published case studies ([5]) ([12]). Each reference provides evidence for the claims and recommendations above, ensuring the report’s conclusions are well-supported.
External Sources (53)
DISCLAIMER
The information contained in this document is provided for educational and informational purposes only. We make no representations or warranties of any kind, express or implied, about the completeness, accuracy, reliability, suitability, or availability of the information contained herein. Any reliance you place on such information is strictly at your own risk. In no event will IntuitionLabs.ai or its representatives be liable for any loss or damage including without limitation, indirect or consequential loss or damage, or any loss or damage whatsoever arising from the use of information presented in this document. This document may contain content generated with the assistance of artificial intelligence technologies. AI-generated content may contain errors, omissions, or inaccuracies. Readers are advised to independently verify any critical information before acting upon it. All product names, logos, brands, trademarks, and registered trademarks mentioned in this document are the property of their respective owners. All company, product, and service names used in this document are for identification purposes only. Use of these names, logos, trademarks, and brands does not imply endorsement by the respective trademark holders. IntuitionLabs.ai is an AI software development company specializing in helping life-science companies implement and leverage artificial intelligence solutions. Founded in 2023 by Adrien Laurent and based in San Jose, California. This document does not constitute professional or legal advice. For specific guidance related to your business needs, please consult with appropriate qualified professionals.
Related Articles

Veeva MyInsights to X-Pages Migration: A Technical Guide
A technical guide to migrating embedded analytics from Veeva MyInsights to Vault CRM X-Pages. Learn the key steps, platform differences, and data settings.

Building Veeva Custom Display Elements (CDEs) with React & Vue
Learn to build Veeva Custom Display Elements (CDEs) for MyInsights & X-Pages using React or Vue. This guide covers CDE architecture and development workflow.

MyInsights Studio Formula Syntax: A Comprehensive Guide
Learn the complete MyInsights Studio formula syntax for Veeva CRM. This guide covers calculated fields, data elements, query filters, and expressions with examp