Domain Security Info

Import and Export

Updated May 1, 2026, 8:29 AM

The import and export tools let you back up system data and restore it later. You can export the knowledge base (brands, tags, and verified domains) as a JSON file, and import it to restore or transfer the data.

Exporting data#

Export creates a JSON file containing the data you select. Use it to:

  • Back up your configuration before making large changes.
  • Transfer data between environments (for example, from a staging system to production).
  • Archive a snapshot of the knowledge base at a point in time.

How to export#

  1. Go to Export under System in the navigation.
  2. Check the boxes for the data types you want to export:BrandsTXT record tagsMX record tagsNS record tagsVerified domains
  3. Click Export.
  4. The system generates a JSON file and downloads it to your computer.

The exported file includes a timestamp showing when the export was created.

What is included#

The export contains the current data for each selected type. It includes all fields: IDs, names, patterns, brand associations, colors, URLs, and other metadata.

The export does not include:

  • Analytics data
  • Audit logs
  • User accounts
  • Known domains
  • IP prefixes
  • Verified ASNs
  • WHOIS cache
  • Domain analysis history

These data types are not part of the standard export because they are either too large, too transient, or system-generated.

Importing data#

Import reads a previously exported JSON file and adds its contents to the system.

How to import#

  1. Go to Import under System in the navigation.
  2. Click Choose File and select a previously exported JSON file.
  3. Click Import.
  4. The system processes the file and reports how many records were imported.

How the import handles existing records#

The import is non-destructive. It uses an "insert or ignore" approach:

  • New records (with IDs that don't exist in the system) are created.
  • Existing records (with IDs that already exist) are left unchanged. The import does not overwrite them.

This means you can safely import a file into a system that already has some of the same data. Existing records will not be modified.

Import order#

The system imports data in a specific order to respect dependencies:

  1. Brands first โ€” because tags and verified domains reference brands.
  2. Tags second โ€” TXT, MX, and NS record tags.
  3. Verified domains last โ€” because they reference brands.

This ordering is handled automatically. You do not need to import files in a specific sequence.

Tips#

  • Export regularly as part of your backup routine, especially before large data changes.
  • Keep exported files secure. They contain your full knowledge base configuration.
  • Test imports in a staging environment before importing into production, especially if the file came from a different system.
  • Check the import results to make sure the expected number of records were created.

Audit trail#

Both export and import operations are recorded in the audit log. The log entry shows:

  • Who performed the operation.
  • When it happened.
  • Which data types were included.
  • How many records were processed.
  • Whether the operation succeeded or failed.