Getting started

Connecting your Bubble app

To use Buildprint with your Bubble app, you'll invite Buildprint as a collaborator and verify ownership. This gives Buildprint access to your app's data, logs, and workflows.

You'll need admin access to your Bubble app and a Buildprint workspace. Buildprint will bypass collaborator limits on your Bubble app, so you can connect Buildprint, even on Starter plan.

Invite Buildprint to your Bubble app

  1. Create a new project in your Buildprint workspace and enter your Bubble App ID. This is the subdomain before .bubbleapps.io in your live app URL (e.g., myapp from myapp.bubbleapps.io), or the part after ?id= in your Bubble editor URL (e.g., myapp from bubble.io/page?id=myapp).

  2. In your Bubble app, go to Settings > Collaboration.

  3. Invite [email protected] as a collaborator.

  4. Grant these permissions:

    • App: View and edit

    • Data: View and run as

    • Logs: View and query

    • Versions: Live and Test (or Dev only if you prefer)

Buildprint only reads data - it won't modify your app unless you explicitly use permit it in both chats and collaborator permisisons.

Verify ownership

After inviting Buildprint, verify that you own the app using one of two methods:

  1. Copy the meta tag from the Buildprint verification screen.

  2. In Bubble, go to Settings > SEO / metatags and paste it into the Script / meta tags in header field for your test version.

  3. Click Verify in Buildprint.

  4. Once verified, you can remove the meta tag.

Admin API token (one-time)

  1. Generate a temporary Admin API token in Bubble.

  2. Paste it into Buildprint's verification screen.

  3. Click Verify.

Buildprint does not store your Admin API token after verification.

Troubleshooting

  • Collaborator not invited: Ensure the collaborator has the permissions specified above, and ensure the Bubble app ID you entered on the previous step is correct (based on the guidelines above).

  • Verification fails: Make sure the meta tag is live on your test version or your API token is current and valid.

  • Status stuck on "Pending": Click Re-verify in Buildprint after updating your collaborator's permission settings.

  • Unable to login with Google: Some ISPs are blocking Buildprint due to a bot attack. You can use email signup, or use a VPN to login with Google.

Was this helpful?