What you can do
- Choose an available import mode and review its required schema.
- Upload and validate a local source file.
- Map source columns and supported source values.
- Run, resume, monitor, review, and export failed import rows.
Find the exact task
How do I import existing business data?
Open Imports, choose an available mode, upload your source file, validate it, map the required fields, and start the import.
- Open Imports.
- Choose the import mode and review its instructions.
- Upload, validate, map, start, and monitor the import.
What file and columns are required?
The required file type and columns are shown by the selected import mode. Review those instructions before uploading rather than assuming one universal schema.
How do I validate an import file?
Choose a file in Imports and run validation before starting the migration. Fix reported rows or fields before continuing.
- Choose the import mode.
- Upload the source file.
- Choose Validate and review any errors or failed rows.
How do I map source columns?
After validation, map each source column to the canonical field requested by the import mode, then submit the mapping.
- Review the mapping workspace.
- Choose the canonical field for each source column.
- Submit the mapping and resolve required-field errors.
How do I map product types or repair statuses?
Use the value-mapping controls when the selected import mode supports them, then map source values to the accepted product, repair, condition, or device values.
- Open the value-mapping step.
- Review the source values detected in the file.
- Choose the accepted value for each source value and save the mapping.
How do I resume an unfinished import?
Return to Imports and let the active import session restore. Continue from validation, mapping, running, or results as appropriate.
- Open Imports again.
- Wait for the active session to restore.
- Continue the displayed step or clear the session before starting unrelated work.
How do I monitor import progress?
After starting the import, stay on the progress surface or return to Imports to poll the backend session until a result is available.
How do I review imported records?
When the import finishes, review the imported counts and result summary, then inspect the destination modules for the records you brought across.
- Wait for the result state.
- Review imported counts and summaries.
- Open the relevant products, customers, repairs, or staff area to confirm the records.
How do I export failed import rows?
Use the result or validation export action to save failed rows as CSV, correct the source data, and retry when appropriate.
- Open the import result or validation errors.
- Choose Export Failed Rows.
- Correct the CSV and run a new import or resume the workflow.
Keep this context in mind
- Validation happens before the import begins.
- Mapping is mode-specific; not every source field or value is available for every import.
- The backend supplies available modes and exact column schemas, so this guide avoids promising a fixed file format list.
Talk to the SpudgerHQ team.
Tell us what you expected to see and which workflow you were trying to complete.