Skip to main content
All CollectionsIntegrationsEmbeds
How to: Embedding Your Marketplace
How to: Embedding Your Marketplace

How to embed your Builtfirst marketplace / community into your own website

Updated over 2 months ago

Clickpath: Marketplaces > Go to Marketplace > Settings > Embed

For marketplace owners that prefer to show their community to Buyers via their own website/third party site, embedding is a great option. This allows you to show Builtfirst pages to users without them having to navigate to your marketplace's subdomain.

Embed still requires users to log in with Builtfirst credentials. To explore other options, check out Auto Sign In and Single Sign On (SSO).

Setting Up the Embed

  1. In whatever webhost you use, create a new page.

    1. We recommend creating a page with the following template: https://yourpartner_name.com/marketplace

  2. Log into your Partner account at manage.builtfirst.com.

    Go to marketplace's settings page: Marketplaces > Go to Marketplace > Settings > Embed


  3. On the Embed page, enter the url for the page you've created on your site. This is where your buyers will go to access the marketplace.

  4. Builtfirst will automatically generate embed codes based on the url you enter above. Copy the code and paste it into your site to complete the embed process.


    We strongly recommend using the javascript code, if possible. However, some website hosts do not allow this. If that's the case, select whichever code is accepted by your host.

🚨 If you change your community's subdomain, this will automatically update your embed code. Remember to save your updated code if you make changes!


Troubleshooting

Buyer Error Messages

The embed requires access to Buyers' saved Builtfirst login data to load. If Buyers report seeing an error message:

  • Ensure they are not in an incognito/private browsing window.

  • Confirm that cookies are enabled in their browser. More information on cookies can be referenced in Allowing Cookies in Your Web Browser.

Buyers Can't Reset Passwords

This most commonly occurs with IFRAME embeds. If your buyers report being redirected to your website when trying to use the password reset link, update your embed to use the javascript code instead. Contact us at support@builtfirst.com if that's not an option for your organization.


Did this answer your question?