LogoLogo
TrustAPI Docs
  • Application
  • Support
  • Platform
  • Infrastructure
  • Security
  • Notices
  • Overview
  • Protect Data
    • Auto Backup
      • Auto Backup API Usage
      • Supported Objects
      • Delete Tracking
      • Salesforce Metadata Backup
      • Missing Field Permissions
      • Viewing Records
      • Viewing Files
    • Archive
    • Restore
      • Restore Best Practices
    • Purge
  • Reuse Data
    • Data Replication
      • Data Replication API Usage
      • Supported Objects
      • Delete Tracking
      • Missing Field Permissions
      • Viewing Records
      • Viewing Files
    • Global Search
    • Data Lake (formerly History Stream)
      • AWS Data Lakehouse
      • DuckDB Data Lake
      • Heroku Data Lakehouse
      • Azure Data Lake
      • Data Lake FAQ
      • Data Lake v1 (formerly History Stream)
    • Salesforce Sandbox Seeding
      • Sandbox Seeding Walkthrough
    • Public API
    • Managed Package
      • Second Generation
        • Features
        • Install
        • Update
        • Uninstall
      • First Generation
        • Features
        • Configure
        • Uninstall
        • Migrate
      • Frequently Asked Questions
  • Other
    • Settings
      • Connecting Salesforce
      • Connecting Storage
      • Sandbox Refresh
    • Notifications
    • Permissions
      • Integration User
      • Integration User Scripts
    • Troubleshooting
      • Debugging Salesforce Triggers
    • Auto Updates

Copyright © 2025 GRAX, Inc.

On this page
  • Who is seeding for?
  • Where to use GRAX Sandbox Seeding in Salesforce
  • How to access GRAX Sandbox Seeding
  • How to get started
  • Sandbox Seeding Workflow
  • Undo Seed, Seed Again
  • Skipped Records
  • Duplicate Records
  • Seeding Jobs
  • Seeding Permission Set
  • Manage Sandbox Seeding Targets
  • Feedback
  • Troubleshooting
  • Salesforce Errors

Was this helpful?

Export as PDF
  1. Reuse Data

Salesforce Sandbox Seeding

Last updated 1 month ago

Was this helpful?

  • Do you struggle with old, stale data and wish your developers could develop and test against the latest production data?

  • Is your company behind on your Salesforce sandbox refresh cycle?

  • Does your team struggle to follow a Salesforce DevOps process?

  • Do your developers all work out of the same sandbox and step on each other's toes while trying to build, test, and ship their code?

  • Do you need to anonymize data in lower sandboxes for training in compliance with privacy laws?

Who is seeding for?

GRAX Sandbox Seeding is built for Salesforce developers and the Salesforce administrators who support them. Seeding helps make your job easier to develop, iterate, test, retest, and ship your new feature or product improvement so you can get to market faster with higher quality results.

Where to use GRAX Sandbox Seeding in Salesforce

GRAX Sandbox Seeding works with all Salesforce org types but immensely improves the experience with Developer and Developer Pro sandboxes, where Salesforce doesn't provide the tooling to propagate data as part of a template-driven refresh.

How to access GRAX Sandbox Seeding

Sandbox Seeding is integrated in three places within the GRAX Application:

Click on Sandbox Seeding in the menu and you will see the button New Sandbox Seeding. This takes you into the Seeding workflow where we mirror our source selection user interface from Archive and provide users with the ability to select records with the familiar choices of Salesforce Report, SOQL Query, CSV, or list of record IDs.

A second entry point for Sandbox Seeding is Global Search. When you click on Global Search in the menu, you will see a table of previously run search jobs. You can create a New Global Search or use a previously run search to select data as the source. Use the checkboxes to select a subset of records or all records and then click the ‘Seed Records’ button to begin the Seeding workflow.

You have the option to tune the size of the graph by using the Maximum Child Level drop down. You also have the options to include archive and deleted records and to be notified by email on this seeding job. Click the save (disk) icon to make your chosen settings the default.

A third method of selecting records for Seeding can be accessed through record details. Either click on any record link or enter the ID in the Lookup By ID box in the header to arrive at the record details view. Clicking on the vertical ellipsis in the header gives you the option to seed. A modal pops up asking you to enter your credentials and presents a similar workflow as the other Seeding source selection methods.

How to get started

  1. Create / refresh an empty Developer sandbox off your production Salesforce org

  2. Choose one record to seed (it's best to start small and see how things work in your org)

  3. Follow the workflow to seed

  4. Undo the seed

Once you are successful with the above steps, you are ready to move on to bigger and more realistic data sets. Remember, Salesforce data is complex, so it's best to start small.

Sandbox Seeding Workflow

GRAX Sandbox Seeding provides a workflow to guide you through the steps to seed data from a source to a destination org.

1

Select the Destination

Choose the seeding target that records will be created within. If you have seeded to this org previously, the seeding destination will be listed in the drop down. If this is your first time seeding to this org, click Add Target Org. Clicking this button pops up a modal asking for your target Org Type and the Salesforce login information for that org (either OAuth or username, password, and security token).

2

Select the Source

There are a variety of options for selecting the records from your main org that you want to seed into the destination. Choose and configure an available source:

3

Configure Options

Choose seeding options. We provide several settings:

  • You can tune the size of the seeding dataset through the Maximum Child Level feature.

  • The option to include deleted and archived records

  • You can disable automated processes including triggers and field validation

  • You can anonymize the seeding data.

4

Preparing the Hierarchy

GRAX builds and graphs the hierarchy of your records to prepare for seeding to the target org. If you used Global Search or the record details view as the Seeding source, you will start on this page of the workflow.

You will notice a Seeding data size estimate versus available space in the target org in the graph header. Use this to make sure your org has enough space for the Seeding data and any development or testing work you need to do.

There is also a list view where you are presented with tools to configure the seed allowing you to skip records, set overrides, and include additional objects referenced by your seed data.

You may not want all objects that are referenced in the graph hierarchy. You have the option to skip objects that you don't wish to include.

Salesforce requires that we maintain referential integrity so certain objects that are referenced by other objects in your seeding data must be included with a seed or you will get an error. To resolve this, you can either include the referenced objects or set an override. Overrides allow you to reference an object that is already in the target org or the seeding data set. We automatically include referenced parent records that are required by Salesforce to reduce the need to set overrides.

The relationships tab allows you to select related objects to bring along with the seed. If you experience an error due to a missing object, try including it with this tool.

5

Seeding the Records

After clicking Seed, the GRAX Application prompts you to confirm and warns you if this is a Production org. You will be presented with a progress indicator as the data is seeded to your target org.

Undo Seed, Seed Again

The Undo Seed feature allows you to seed data to a sandbox, do experiments, test things, and then remove the data from the org. Right next to this is the button to Seed Again to put a fresh copy of the data back into the sandbox to replay your tests. If you have added child records to a parent that was seeded, an error is shown that we couldn't remove all of the records and a list of records that need to be manually deleted in Salesforce is provided.

If you have not yet undone a seed and click "Seed Again," you will get a pop up modal warning that prompts you to undo that seed.

Skipped Records

If a completed seeding job shows that records have been skipped due to mapped to existing record, this indicates that there is already a record in your sandbox with the same id; this typically occurs with full copy sandboxes and records will not be seeded if there are existing records with the same ids in the target org.

Duplicate Records

If seeding a record that has already been previously seeded, this will produce a duplicate record in the target org with a new ID and will result in two records with the same values and different IDs.

Seeding Jobs

Prior seeding jobs are shown in the Sandbox Seeding tab of the menu. Click on a prior Seeding job to see the job details, as well as an option to seed the data set again.

Seeding Permission Set

GRAX Sandbox Seeding can be enabled for users by adding the permission set: "GRAX Console Seeding Permission". Contact your GRAX or Salesforce Administrator to request access to this permission set.

Manage Sandbox Seeding Targets

This can be found within the Archive, Restore & Seeding section of the Settings page and allows you to see a list of connected target orgs, remove them, or add new target orgs.

You will also see an option for Allowed Production Orgs; adding a production org to this list will then allow you to add it to the Sandbox Seed Targets list, but this should be used with caution as seeding to a production org is not a regular use case.

Feedback

GRAX regularly schedules meetings with customer teams to capture input on functionality and features. Please send all comments, feedback, and refinements to GRAX Customer Success.

Troubleshooting

Salesforce Errors

Due to the complexity of Salesforce, you will sometimes experience errors when Seeding that require your intervention to get 100% of the records to seed. Some of these errors can be resolved by skipping objects, overriding fields, or adding relationships but sometimes they are purely due to Salesforce API rules. Causes may include triggers, permissions, or old data and such issues will be prefixed by 'Salesforce error:'. A partial list of these errors with suggested resolutions can be found . There is typically some back and forth to fully satisfy Salesforce rules, but with normal usage, troubleshooting becomes easier. GRAX also logs each error in our systems to help you debug.

If you need additional assistance contact .

here
Creating a Seeding Job via the Sandbox Seeding Tab
Creating a Seeding Job via Global Search Results
Seeding Job Configuration from Global Search
Seeding a Record from the Record Details Page
Selecting Seeding Destination
Selecting Seed Records Source
Configuring Seeding Options
Prepared Seeding Record Hierarchy
Alternate List View with Additional Options
Field/Value Overrides
Optional Relationship Inclusion
Seeding Job Details
Completed Seed Job Details with Undo Button
"Seed Again" Warning Message
Seeding Jobs List
Seeding Targets List
GRAX Support