Merge pull request #4335 from coralproject/docs/CORL-2886-update-docs…

…-shadowdomcall-webview-apps [CORL-2886]: add web view troubleshooting info to docs
coralproject · Sep 26, 2023 · f059296 · f059296
2 parents 296634a + f1411f6
commit f059296
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 0 deletions.
diff --git a/docs/docs/migrating-6-to-7.md b/docs/docs/migrating-6-to-7.md
@@ -57,6 +57,14 @@ html {
 
 4. If your site has a Content Security Policy that prohibits websocket (`wss://`) requests, you will need to update it to whitelist `wss://[your coral URL]/api/graphql/live` in order for live updates to function.
 
+## Native mobile applications
+
+- If the Coral embed is not loading in web view after this update, you may need to add in this call:
+
+```js
+webView.getSettings.setDomStorageEnabled(true);
+```
+
 ## After Coral has been updated to v7
 
 Once the update is complete and you are running v7, you may wish to undo some of the previous steps for better maintainability:

diff --git a/docs/docs/mobile.md b/docs/docs/mobile.md
@@ -29,3 +29,11 @@ Integration with native mobile applications is done through web view, you will n
 This will initialize the Coral stream with a logged-in user.
 
 5. You will need to use the same method to pass a Story ID or Story URL to the embed code using the `storyID` or `storyURL` options passed to `createStreamEmbed`. See [CMS Integration](/cms) for more details.
+
+### Troubleshooting
+
+If the Coral embed is not loading in web view, and you are using Coral >= v7.0.0, you may need to add in this call:
+
+```js
+webView.getSettings.setDomStorageEnabled(true);
+```