Mobile and Offline Developer Guide
j
No Results
Search Tips:
- Please consider misspellings
- Try different search keywords
Feature Limitations of Offline GraphQL
While using different code isn’t necessary, you must restrict the GraphQL features that you use in your queries. The Offline GraphQL wire adapter supports a subset of the features supported by the standard LWC wire adapter.
Let’s get to the largest disappointments first. These major features don’t work while offline.
- 🚫 Aggregate queries
- 🚫 Mutations (data modification)
These major features are partially supported.
- ⚠️ Pagination
- Pagination is supported on top-level record queries, but not on nested child queries.
Where these features are required for your component or app to function, you must build them yourself, or use other data access mechanisms besides GraphQL.
Data Access (Record Queries)
For “normal” data access, read-only queries that retrieve record data, most features are supported. These features are supported, but with some limitations.
- Most scalar field operators are supported.
- ✅ Boolean operators and, not, and or are supported when the nested predicates (subclauses) use supported features.
- ⚠️ Geolocation and other compound fields have limited support. Location-based filtering isn’t supported.
- ⚠️ Sometimes picklist and multi-picklist results don’t exactly match results from the online implementation, particularly if null values are included in the predicate.
- ⚠️ Relative date filtering is based on the device locale, not the org locale setting.
- ✅ DisplayValue for records and displayValue for fields are both supported.
- ✅ first argument to limit query result size is supported.
- 🚫 While first isn’t a pagination feature, it’s often used with pagination features that aren’t supported.
- ⚠️ scope argument:
- ✅ MINE is supported for all entities.
- ✅ ASSIGNEDTOME is supported for ServiceAppointment.
- 🚫 No other scopes are supported by Offline GraphQL.
- ✅ orderBy
- ⚠️ Ordering is supported, but it can have a negative impact on performance. Keep in mind where the sorting takes place, that is, your phone. Keep your sort criteria simple, and don’t sort more records than necessary.
- ⚠️ Ordering results by a picklist field sorts by the picklist label, rather than the order of the picklist values defined in Setup.
- ✅ Relationships and related record access:
- Parent-to-child relationships are supported.
- Child-to-parent relationships are supported.
- Polymorphic relationship fields such as Owner are supported.
These features aren’t supported at this time.
- 🚫 Compound fields such as Account.ShippingAddress aren’t supported in selections, predicates, or orderBy clauses.
- 🚫 Semi-join and anti-join filters such as inq and ninq aren’t supported.
- 🚫 in and nin operators aren’t supported for Date and Date/Time fields.
- 🚫 Location-based filters aren’t supported.
- 🚫 Fiscal date literals aren’t supported in filters.
- 🚫 Relative date ranges such as “last 30 days” aren’t supported in filters.
Metadata
Necessary object metadata, such as custom objects, fields, and layouts, is automatically loaded and cached during priming and online activity. With GraphQL, you can manually query for metadata when the occasion calls for it. When offline, there are some limitations.
- ⚠️ Metadata fetched through GraphQL is cached separately from metadata fetched through the getObjectInfo wire adapter. Sometimes they’re not perfectly in sync.
- ⚠️ Related list metadata can work, but it’s not supported at this time.
Other Feature Considerations
- Record query pagination:
- ⚠️ The after argument to paginate results is supported on top-level record queries. However, the after argument to paginate results for nested child relationship queries isn’t supported.
- 🚫 Cursor field selections aren’t supported.
- ⚠️ GraphQL query performance can be suboptimal on complex queries that filter or order by non-indexed fields.
- ⚠️ Queries that reference offline-created (draft) records in the predicate, directly in the query or indirectly through variables, return locally cached results only. The query doesn’t make a network request to the server.