---
title: Sandbox Deployment
slug: sandbox-deployment
createdAt: 2026-07-27T13:23:34.627Z
---

## Overview

The Altrata Salesforce Sandbox Environment allows you to test and validate your Salesforce integration before deploying to production.

A sandbox environment provides a dedicated non-production environment that is separate from your production Altrata account. This allows your team to validate authentication, configuration, matching behaviour and user workflows without impacting your production implementation.

A sandbox environment includes:

| ****<font color="#4283c7">**Component**</font>**** | <font color="#4283c7">**Purpose**</font>****                   |
| -------------------------------------------------- | -------------------------------------------------------------- |
| Sandbox Account                                    | Dedicated Altrata testing environment                          |
| Service User                                       | Used by the Salesforce App for authentication                  |
| API Key                                            | Used for API connectivity                                      |
| Web User                                           | Allows users to access and test Altrata functionality directly |

## When should I use a sandbox?

We recommend using a sandbox if you are:

- Migrating from a Foundation App (Wealth-X, BoardEx or RelSci)
- Implementing complex Field Mapping rules
- Testing custom automations or workflows
- Rolling out to a large number of users
- Performing user acceptance testing before go-live

Using a sandbox allows you to validate your configuration and deployment process before introducing changes into production.

## How the sandbox environment works

The Altrata sandbox environment is a separate environment from production.

When a sandbox account is provisioned, it is created as a dedicated sandbox account with its own:

- Service user (used by the Salesforce App for authentication)
- Web user (used to test user-facing functionality)
- API key
- Authentication credentials

Sandbox credentials are different from production credentials and must be configured separately within the Altrata Salesforce App.

Production and sandbox environments can be used at the same time.

## What can I test in a sandbox?

A sandbox supports the same core integration workflows as production.

You can:

✅ Install the Altrata Salesforce App

✅ Configure authentication

✅ Test API connectivity

✅ Configure and test Field Mapping

✅ Run bulk matching

✅ Run manual matching

✅ Validate enrichment behavior

✅ Test Lightning page layouts

✅ Validate automation processes

✅ Test user workflows

✅ Test user-contributed content

✅ Validate reports and dashboards that depend on Altrata data

✅ Perform migration and deployment testing

This makes the sandbox environment suitable for validating your end-to-end deployment before go-live.

## What data is available in the sandbox?

Sandbox environments use the same underlying Altrata profile data available through your production subscription.

This means users can test against real Altrata profile data and subscription entitlements.

Synthetic or sample profile data is not currently available.

## Is sandbox content isolated from production?

Yes.

Sandbox environments are designed to be isolated from production environments.

The sandbox account uses separate users and separate contributed content from production. Relationships and other user-created content remain within the sandbox environment and do not share with the production account.

## Authentication

Sandbox authentication works in the same way as production.

The Salesforce App is configured using:

- Username
- Password
- API Key

The only difference is that sandbox environments use sandbox-specific credentials which are provided separately from production credentials.

:::BlockQuote
🛑 Do not use production credentials in a sandbox environment.
:::

| <font color="#4283c7">**Environment**</font>**** | ****<font color="#4283c7">**User Type**</font>**** | ****<font color="#4283c7">**Example Username**</font>**** |
| ------------------------------------------------ | -------------------------------------------------- | --------------------------------------------------------- |
| Production                                       | Service User                                       | svc-abc-crm                                               |
| Sandbox                                          | Service User                                       | svc-abc-crm.sandbox                                       |
| Production                                       | Web User                                           | alex\@abc.com                                             |
| Sandbox                                          | Web User                                           | alex\@abc.com.sandbox                                     |

This allows the same individual to access both production and sandbox environments using separate accounts.

Your sandbox credentials will be provided when your sandbox environment is provisioned.

## Current capabilities

The sandbox environment currently supports:

✅ Dedicated sandbox account

✅ Dedicated sandbox credentials

✅ Dedicated sandbox API key

✅ Salesforce integration testing

✅ API testing

✅ Subscription replication

✅ Product configuration replication

✅ Isolated user-contributed content

✅ MFA authentication

✅ Parallel production and sandbox operation

## Current limitations

| ****<font color="#4283c7">**Limitation**</font> | <font color="#4283c7">**Details**</font>                                                                           |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Single Sign-On (SSO)                            | Sandbox environments currently support password and MFA authentication only. SSO is not available.                  |
| Sandbox reset                                   | There is currently no one-click reset mechanism.                                                                    |
| Copying production content                      | Content cannot be copied from production into sandbox.                                                              |
| Sample data                                     | Synthetic or demo profile data is not available.                                                                    |
| User synchronization                            | Changes to production users are not automatically mirrored to sandbox users.                                        |
| Sandbox capacity                                | Sandbox environments are provisioned with 1 service user and 1 web user and are intended for testing purposes only. |

## Frequently Asked Questions

### Can I use production and sandbox at the same time?

Yes.

Production and sandbox environments operate independently and can be used simultaneously.

### Can I use SSO in a sandbox?

No.

Sandbox environments currently support password and MFA authentication only.

### Can I generate synthetic or demo data?

No.

Sandbox environments use the same Altrata profile data available through your subscription. Synthetic data is not currently supported.

### Can production content be copied into a sandbox?

No.

This option is not available.

### Can multiple users test in a sandbox?

Sandbox environments are initially provisioned with one service user and one web user.

Testing that requires user-contributed content should be performed using the sandbox web user.

If your testing requirements extend beyond the standard allocation, contact your Altrata representative to discuss your requirements.