Before You Start

File requirements:

  • Only one CSV file can be uploaded at a time

  • Maximum 1,000 rows per file

  • Required column order:

Target Address, Label, Tags

Notes:

  • Only the Target Address column is required

  • Tags should be comma-separated

  • Tags are case-insensitive

  • New tags will be created automatically with a default color

Supported Target Formats

TopScan accepts:

✅ Public IPv4 addresses
✅ Hostnames and domains (including IDN)
✅ CIDR ranges (automatically expanded into individual IPs)

TopScan does NOT accept:

❌ Local/private IP addresses (e.g., 192.168.x.x, 10.x.x.x)
❌ Invalid host addresses
❌ Duplicate targets within the same workspace (Target + Type must be unique)

How to Import Targets

  1. Go to Targets → Add target

  2. Drag and drop your CSV file or click the upload area

  3. Wait for validation to complete

  4. Review the preview and summary

  5. Click Add targets to confirm

Nothing is added until you confirm.

What Happens During Validation

Each row is checked automatically.

Valid rows:
✔ Included in the import

Invalid rows:
✖ Skipped entirely (tags from those rows are not processed)

If your file exceeds 1,000 rows, you will see:

You can upload a maximum of 1,000 targets via the CSV file at a time. If you need more, you can upload them one by one.

Preview

After validation:

  • The first 100 parsed targets are displayed

  • If more exist, the preview shows a partial list for reference

  • The file becomes read-only

Use the preview to confirm formatting before import.

Summary Explained

You will see a summary similar to:

  • N lines in the uploaded file

  • M targets will be added

  • K targets are invalid

  • L tags recognized

  • O tags are invalid

Rows with a value of 0 are hidden.

If invalid targets or tags exist, download the validation log for details.

CIDR Behavior

When a CIDR range is uploaded:

  • It is expanded into individual IP targets

  • Only new IPs are added

  • Existing targets are skipped

  • The summary reflects the actual number of targets that will be created

Best Practices

  • Keep files under 1,000 rows

  • Remove private IP ranges before upload

  • Use labels to group environments (e.g., prod, staging)

  • Apply tags for filtering and reporting

If you only need to add a few targets (1–10), manual entry is faster. CSV import is optimized for bulk operations.