Settings & Integrations

How do I import patients and records from another system?

Last updated: 2026-11-19

Open Settings → Import and click Start new import. Choose an Import type — EpikDoc format, Practo, or Scanned documents (JPG / PDF) — upload your file, review the summary and the flagged rows, then confirm the import. Nothing is written until you review and confirm, and every import can be rolled back from the history. For a handful of scanned files, use Quick add scanned documents instead.

Run an import

  1. Open Settings → Import and click Start new import. The steps are Source, Upload, Review and Import.
  2. Under Import type, pick EpikDoc format or Practo (under Patient records), or Scanned documents (JPG / PDF) (under Patient files).
  3. Drag your file in or click browse files. For EpikDoc format you can download a template first with Download template.
  4. Wait while EpikDoc Pro reads the sheets, checks the headers and counts the rows. It does not write anything yet.
  5. On Review, check the summary and the Rows that need attention table. You can give the import a name (optional). Rows with errors that cannot be fixed automatically block the import — fix them in your file and upload again.
  6. Click the Import button, which shows the number of records. When it finishes, choose View in import history or Import another file.

What you can upload

  • EpikDoc format — a ZIP of CSV files (or loose .csv files, which EpikDoc Pro bundles for you). Total size up to 50 MB.
  • Practo — a ZIP export (.zip) from Practo Ray. EpikDoc Pro maps the columns to its fields while checking. Total size up to 50 MB.
  • Scanned documents (JPG / PDF) — one ZIP of scans, up to 5 GB. Name each file First_Last_PatientID_YYYY-MM-DD_HH-MM-SS_anything.pdf. Only jpg, jpeg and pdf files are attached; other types are skipped, and folder names inside the ZIP are ignored.

The Naming guide on the upload screen explains the file-name parts: name (first and last), Patient ID (capitalisation, spaces and hyphens do not matter, so p1042, P1042 and P-1042 all match), and date and time of the scan, which becomes the document’s date in the patient’s Files tab. Files whose name does not match, or whose Patient ID is not in your clinic, are never attached silently — you see the counts on the review step. If some files point to a Patient ID that does not exist yet, you can tick Create new patient(s) for files with no match to create those patients from the file name.

Flagged rows, history and rollback

  • Import history lists every import. For a checked-but-not-yet-imported file, Commit import finishes it and Discard drops it; it wrote nothing.
  • Download log gives you a CSV. For an import that was only checked, it is a flagged-rows file listing the entity, row, column and reason code of each flagged row (no patient details); it is saved as import-<id>.flagged.csv. If nothing was flagged you see a message saying so.
  • Rollback undoes an import. You must type rollback to confirm, then click Rollback.

Quick add scanned documents

Next to Start a new import, the Quick add scanned documents card lets you drop PDFs or photos — or a whole folder — without making a ZIP. Click Add documents. Name files with the patient’s name, ID or date of birth in any order (for example Asha Rao_P1042_1988-04-12.pdf). Accepted types are pdf, jpg, jpeg and png, and up to 300 files per batch. Every file is matched to a patient in a table before anything uploads; for each row choose Attach, Create new patient or Skip, then upload. A folder named for the patient attaches everything inside it to them. For bigger migrations, use the ZIP importer.

Related guides

Was this guide helpful?

Still need help? Choose how you’d like to ask.

Tickets to the EpikDoc team need you to sign in. You can also email support@epikdoc.ai.