Skip to content

Commit 6999b06

Browse files
committed
Add troubleshooting guidance for Connect popup issues
1 parent 5403da4 commit 6999b06

File tree

2 files changed

+10
-0
lines changed

2 files changed

+10
-0
lines changed

docs-v2/pages/connect/managed-auth/quickstart.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,10 @@ npm i --save @pipedream/sdk
9797

9898
When the user connects an account in your product, [pass the token from your backend](#generate-a-short-lived-token) and call `connectAccount`. This opens a Pipedream iFrame that guides the user through the account connection.
9999

100+
<Callout type="info">
101+
If the Connect popup window doesn't open when users try to connect their accounts, set your `Cross-Origin-Opener-Policy` header to `same-origin-allow-popups`. This fixes cases where the Connect popup can't open because a default "same-origin" policy blocks popups from iframes.
102+
</Callout>
103+
100104
Try the interactive demo below to connect an account after generating a token in the previous step:
101105

102106
<div className="not-prose">

docs-v2/pages/connect/managed-auth/troubleshooting.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,12 @@ Double-check the app slug you're passing [when connecting your user's account](/
4646

4747
The user may have closed the OAuth popup window without completing authorization.
4848

49+
### Connect popup doesn't open
50+
51+
If the Connect popup window doesn't open when users try to connect their accounts, this is often due to the browser's Cross-Origin-Opener-Policy blocking popups from iframes.
52+
53+
Set your `Cross-Origin-Opener-Policy` header to `same-origin-allow-popups` on the page hosting Connect. This fixes cases where the Connect popup can't open because a default `"same-origin"` policy blocks popups from iframes.
54+
4955
<Callout type="info">
5056
If you're still have trouble or hitting an error that isn't listed here, [get in touch with us](https://pipedream.com/support). We'd love to help.
5157
</Callout>

0 commit comments

Comments
 (0)