Skip to main content
If you’re running into build errors with your framework, check out the following troubleshooting steps:
  • Gatsby
  • NextJS
  • Create React App
  • Vite
If you’re using a framework like Gatsby and are running into build errors, check out some common errors below, and how to resolve them.

​
iframe not initialized

If you encounter an error like the one below:
iframe not initialized
There is likely an issue with how you are rendering the PrivyProvider component within your app.Namely, if you are using Gatsby’s wrapRootElement to wrap your app with the PrivyProvider, you should use wrapPageElement instead, like below:
gatsby-browser.tsx
import React from 'react';

import {PrivyProvider} from '@privy-io/react-auth';

export const wrapPageElement = ({element}) => {
  return <PrivyProvider appId={'insert-your-app-id'}>{element}</PrivyProvider>;
};
Though Gatsby typically recommends using wrapRootElement for React Contexts, the PrivyProvider component contains UI (HTML) elements as well, including a dialog (the Privy modal) and an iframe (the Privy iframe, used for embedded wallets). Given these UI elements, wrapPageElement must be used instead of wrapRootElement.
Still have questions? Reach out to our support team – we’re here to help!
⌘I