Introduction
Changing the domain name for your BuddyBoss App allows you to update your app’s connection settings without unpublishing the old version.
This process reconnects your BuddyBoss App license to a new domain, ensures the mobile app communicates with the correct backend, and keeps all app features working seamlessly after migration.
Reconnect Your BuddyBoss App License to the New Domain
- Log in to your WordPress Dashboard.
- Go to BuddyBoss App > Configure.
- Update the Domain Name field to reflect your new domain (e.g., app.yourdomain.com).
- Click Save Settings.
Reconfigure Your iOS App
- Navigate to BuddyBoss App > Configure > iOS Settings.
- Enter your new domain in the appropriate field.
- Review and update any related settings affected by the domain change (e.g., redirect URLs, API endpoints).
- Click Save Settings.
Reconfigure Your Android App
- Go to BuddyBoss App > Configure > Android Settings.
- Update the Domain Name field with your new domain.
- Adjust other configuration details if needed (e.g., REST API endpoints, app links).
- Click Save Settings.
Build and Release an Updated App Version
After updating your domain in both iOS and Android configurations:
- Generate a new build of your app.
- Publish it to the App Store and Google Play Store.
This ensures that your mobile app communicates with your new backend domain. Users running older versions will not be able to connect correctly until they update.
Enable the Minimum Build Version
Once your updated app is live:
- Go to BuddyBoss App > Configure.
- Enable Minimum Build Version.
- Set it to the new version number that includes your domain update.
- Click Save Settings.
This feature forces users to update to the latest app version, ensuring compatibility with your new domain.
Test Your Configuration
Before and after releasing the new build:
- Verify that your app connects properly to the new domain.
- Check user authentication, API requests, and media loading.
- If issues occur, review your DNS, SSL, and REST API/JWT settings.
Always test on both iOS and Android devices using real accounts to confirm smooth connectivity.
Troubleshooting and FAQs
Q: What changes or risks should I expect when switching to a new domain?
A: When changing your primary domain, both your BuddyBoss Web and App will need to reestablish their connections to the new domain. You may experience temporary downtime or authentication errors if configurations are not updated properly. Always test the new domain setup before making it live to ensure seamless connectivity and avoid login or data-sync issues.
Q: Which BuddyBoss App settings need to be updated after a domain change?
A: You’ll need to update the following configurations inside BuddyBoss App > Configure:
- iOS and Android app domain fields
- REST API / JWT Authentication URLs
- Whitelisted domain entries (if applicable)
After saving your changes, you’ll need to generate and publish a new build of your mobile app with the updated domain configuration. This ensures users connect to the correct site backend.
Q: Will this affect our existing App Store or Play Store listings?
No, your app listings remain active. However, if your Privacy Policy URL, support links, or screenshots include your old domain, you’ll need to update those in your Apple App Store and Google Play Console settings.
Your bundle ID, certificates, and provisioning profiles remain the same and do not require updates unless you’re changing your app’s package name or publisher.
A: How do we update iOS Universal Links and Android App Links?
You’ll need to upload new configuration files to your new domain:
- apple-app-site-association > for iOS Universal Links
- assetlinks.json > for Android App Links
These files should list your new domain and all relevant paths that need to open directly in the app. This ensures in-app routing and deep links continue to work properly after the domain transition.
Q: What do we need to update for authentication and social logins?
A: If you’re using OAuth, Social Login, or JWT/REST API authentication:
- Update your redirect URIs and allowed domain lists to include the new domain.
- Check your BuddyBoss Platform and any third-party integrations to ensure authentication callbacks point to the correct URLs.
Failing to update these may result in login errors or failed token exchanges.
Q: Do we need to change anything for push notifications?
A: No changes are typically needed for APNs (Apple) or FCM (Google) keys, certificates, or project IDs, since these are tied to your app, not your domain.
However, if your push notification payloads include URLs (such as links to posts or groups), make sure those URLs now point to the new domain.
Q: Are there any CORS, CDN, or asset issues to watch out for?
A: Yes, you may encounter CORS (Cross-Origin Resource Sharing) or mixed-content warnings if fonts, images, or scripts are still being served from your old domain or unsecured links (HTTP instead of HTTPS).
To avoid issues:
- Ensure all assets use HTTPS and the correct new domain.
- Update CDN and cache configurations to point to the new URLs.
- Clear all caches and verify that in-app assets render correctly.
Q: Do you have a recommended step-by-step guide for switching domains?
A: Yes! Here’s a recommended domain transition checklist:
- Set up the new domain, SSL, and DNS records.
- Update WordPress Home URL and Site URL.
- Configure 301 redirects from the old domain to the new one.
- Update your BuddyBoss App configuration (iOS & Android settings).
- Generate and release a new app build.
- Enable Minimum Build Version to require users to update.
- Upload new deep link configuration files (apple-app-site-association and assetlinks.json).
- Test login, deep links, push notifications, and media rendering.
- Monitor app and website performance post-launch to confirm stability.