> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetorbis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Companies

> Bring companies into Orbis via CSV upload, manual entry, or automatic creation from contacts.

There are several ways to add companies to your Orbis workspace.

## Auto-created from contacts

When you add or import a contact with a company name or domain, Orbis creates a company record automatically if one doesn't already exist. The contact is then linked to that company.

## Added manually

To add a company without an associated contact, click **Add Company** in the companies list. Enter the company name and domain, then save. Enrichment runs automatically once the domain is known.

<Tip>
  Adding a domain is the most important step — Orbis uses the domain to fetch the logo, match the company against enrichment databases, and deduplicate against existing records.
</Tip>

## Company directory

When adding a company manually, Orbis searches a directory of **3.37M+ reference companies** for autocomplete suggestions. This helps you find and add companies with pre-populated data, and avoids creating duplicates.

## CSV import

You can import companies in bulk via CSV:

<Steps>
  <Step title="Open the import modal">
    Click **Import** in the companies list toolbar, or use the Data Wizard from Deep Search.
  </Step>

  <Step title="Upload your CSV">
    Drag and drop or select a CSV file (up to 2,000 rows). Orbis shows a 5-row preview.
  </Step>

  <Step title="Map columns">
    Orbis auto-maps common headers (e.g., "headcount" maps to employee count). Review and adjust mappings. Unmapped columns can be imported as custom properties with auto-type inference.
  </Step>

  <Step title="Import">
    Click **Import**. Orbis normalizes domains (strips protocol, www, and paths), validates format, and skips duplicates. A tag is auto-created from the filename.
  </Step>
</Steps>

After import, a saved filter view is automatically created so you can quickly find your imported companies.

### Supported fields

The column mapping UI organizes fields into groups:

<CardGroup cols={2}>
  <Card title="Core identity" icon="building">
    Name, domain, industry, sector, type, description
  </Card>

  <Card title="Size and financials" icon="chart-line">
    Employee count, revenue range, funding stage, total funding
  </Card>

  <Card title="Location" icon="map-pin">
    City, region, country, full address
  </Card>

  <Card title="Social and links" icon="link">
    LinkedIn, Twitter, Facebook, GitHub, website
  </Card>
</CardGroup>

### Validation

* **Domain is required** — rows without a domain are skipped
* **Domain format** is checked and normalized
* **Duplicate detection** by domain — existing companies are skipped
* Rate limited: 2,000 rows per file, 5,000 per 15 minutes, 20,000 per day

### Import summary

After import completes, a summary shows how many companies were added, skipped (duplicates), and failed. Failed rows can be exported as a CSV for review.
