Managing Multiple Marketplaces

📖 6 min read 🟡 Intermediate

If you operate multiple Sharetribe marketplaces, or manage separate Live and Test environments for a single marketplace, TribeOps allows you to link all accounts to a single admin panel and switch between them instantly.

Step 1: Connecting a New Marketplace Account

To connect an additional Sharetribe account, navigate to Settings > Accounts and click Add Account. You will need to provide the following details:

  1. Account Name: A friendly label (e.g. "Main Marketplace - Live" or "B2B Portal - Test").
  2. Environment: Specify whether it is Live or Test. This affects the API write delays automatically to prevent rate-limit blocks.
  3. Sharetribe Client ID & Client Secret: Retrieve these from your Sharetribe Console under **Build > Integration API**.
  4. Marketplace ID: Your unique Sharetribe marketplace identifier.

💡 Pro Tip: Always click Test Connection after saving. TribeOps will query the Sharetribe API using the credentials to ensure they are valid before allowing active state transitions.

Step 2: Switching Contexts

Once multiple accounts are connected, an Account Switcher dropdown appears in the main dashboard sidebar. Selecting an account will:

  • Store the active account ID in your encrypted session cookie.
  • Instantly refresh the Dashboard, Listing grid, Schema manager, and Zoho sync pages to display data scoped to the selected marketplace.
  • Isolate background jobs: any bulk actions you launch will be routed only to the selected account's API.

Step 3: Security & Cache Isolation

Because multiple marketplaces share the same database tables (like imports, jobs, and settings), TribeOps scopes all cache keys and locks using the format sharetribe_{account_id}_{cache_key}. This prevents token contamination or background jobs leaks across environments.

⚠️ Critical Security: Double check the active account label in the sidebar before initiating destructive bulk actions (like bulk close or delete) to ensure you do not execute changes on a live marketplace when intending to update a test workspace.