Organizations

Metaforce centralizes all your Salesforce organizations in one clean, unified workspace. Connect Sandboxes, Scratch Orgs, Developer Editions, and Production environments with secure authentication, and access them anytime with 1-click passwordless login.

Connecting a Salesforce Org

Metaforce provides a streamlined connection modal designed with a single decision path:

1. Click New Organization in the toolbar.
2. Select your environment type from the segmented controller:
   • Production: Standard Salesforce production login (login.salesforce.com).
   • Sandbox: Standard Salesforce test sandbox login (test.salesforce.com).
   • Custom Domain: Connect via your company's custom My Domain or SSO endpoint (e.g. yourcompany.my.salesforce.com).
3. If connecting via Custom Domain, enter your domain name or URL. Metaforce validates the hostname in real-time and shows the exact HTTPS endpoint preview below the input.
4. Click Connect to open the standard Salesforce OAuth authorization window.
5. Log in with your Salesforce credentials and click Allow to grant Metaforce API access.

Import from JSON

If you already have Salesforce auth credentials (or exported session data from SFDX / CI), you can click the Import JSON icon button in the top-right corner of the connection modal to connect instantly without entering credentials in a browser.

Security & Local Credential Storage

Metaforce connects via official Salesforce OAuth 2.0 Web Server Flow.

• Zero Cloud Storage of Passwords: Metaforce never sees, transmits, or stores your Salesforce master passwords.
• Local Isolated Vault: Your OAuth access tokens, refresh tokens, and org metadata are saved locally on your computer inside Metaforce's protected app data directory.
• Revocable Access: You can revoke connection permissions at any time from Salesforce Setup (Connected Apps OAuth Usage) or delete the connection directly in Metaforce.

Available Org Actions

Each connected organization card and table row provides quick-access actions:

1-Click Login in Browser

Open your Salesforce organization in your default browser with a single click. Metaforce automatically generates a secure frontdoor session URL, bypassing the password and MFA prompt for daily access.

Login in Incognito Window

Need to log into multiple orgs or test user profiles without cookie collisions? Click Open in Incognito to launch an isolated private browser window, keeping your main browser tabs clean.

Drag & Drop Sorting and Grouping

• Custom Sort: Freely reorder org cards or table rows by dragging the handle to prioritize the orgs you use most.
• Group by Company: Automatically group connections by company or business unit for clean multi-client management.

Free Plan Quota & Connection Management

The Free Plan includes connection capacity for your primary orgs. When you exceed the free tier connection quota:

• Existing active connections remain fully operational.
• The most recently added excess connections are safely frozen (read-only state) without losing your configuration or credentials.
• Upgrading to Metaforce Pro or signing in instantly unfreezes all connections across all your devices.