The Import Center in Yrka is the review-first intake surface for payroll history, schedule events, resource files, and employee records. Every import follows the same pattern: upload a supported file, map columns to Yrka fields, review validation results, and commit only the rows you have reviewed and approved. Nothing is applied to production records without your explicit commit — imports do not silently mutate data.Documentation Index
Fetch the complete documentation index at: https://docs.yrka.io/llms.txt
Use this file to discover all available pages before exploring further.
XLS/XLSX workbook imports are currently disabled. Convert workbook files to CSV or TSV before uploading. This applies to payroll, schedule, and other import types.
Import Center overview
Open Admin Tools > Imports to access the Import Center. The main view shows domain import mode tabs and a data-movement queue that surfaces integration sync events, provider handoffs, notification delivery evidence, and failed records alongside your file imports.Import modes
| Mode | What you import |
|---|---|
| Payroll | Historical payroll records, timecard history, pay data |
| Schedule | Schedule events and shift assignments |
| Resources | Source documents for Resources review and knowledge chat |
| Employees | Employee roster data (available when enabled for your organization) |
| All history | Combined view of all import activity, provider sync jobs, webhook replay candidates, and handoffs |
| Failed | Batches and rows that could not commit and need attention |
| Needs review | Batches waiting on mapping, validation decisions, or admin action |
Payroll imports
Payroll imports let you bring historical timecard and pay data into Yrka. After import, committed records appear in Timekeeping and Payroll contexts.Supported file profiles
- Generic CSV/TSV — standard comma- or tab-separated payroll export
- Foundation Payroll — Foundation-oriented column layout
- QuickBooks Time — QuickBooks Time export format
- Custom — configured column mappings saved as a reusable profile
Importing payroll data
Open Payroll in Imports
Go to Admin Tools > Imports and select Payroll. You need the
payroll.import permission to upload or commit.Upload the file
Select your CSV or TSV file. Yrka creates an import batch, stores normalized row previews, and auto-detects common column names.
Review detected columns and employee matching
The preview shows detected columns alongside Yrka fields, matched employees (matched by employee number, payroll ID, email, or name), duplicate timecard row flags, and any validation warnings. Check each before mapping.
Map source columns
Map each source column to the corresponding Yrka field. For common profiles (Foundation, QuickBooks Time), many columns will auto-map. Review auto-mapped columns before committing — do not assume auto-mapping is always correct.
Revalidate
After updating mappings, revalidate the batch. Resolve any remaining errors or warnings before proceeding.
Commit ready rows
Select Commit to apply ready rows only. Committing a payroll batch can:
- Update employee payroll fields
- Create missing job catalog rows
- Insert historical timecards
- Adjust PTO/VAC balances through the leave ledger
Schedule imports
Schedule imports bring shift and assignment data from external systems into your Yrka schedule calendar.Supported file formats
- ICS — standard calendar export format (from Google Calendar, Microsoft 365, Apple Calendar, or other calendar tools)
- CSV — schedule data in comma-separated format with common schedule column patterns
Importing schedule data
Open Schedule in Imports
Go to Admin Tools > Imports and select Schedule. You need the
schedule.import permission. You can also access schedule import from the Schedule header’s Import shortcut.Upload the file
Upload your ICS or CSV file. Yrka creates a schedule import batch, stores row previews, detects common schedule columns, and matches employees by name, email, or employee number.
Review row previews and employee matching
Check each row for matched employees, flagged duplicates, and conflicts with existing schedule events. Rows without matched employees cannot be committed until the identifier is corrected.
Select the target calendar
Before committing, confirm the target Schedule calendar shown on the batch. This is the internal Yrka calendar where committed events will land. Provider calendar names and Yrka schedule calendars are separate — make sure the right one is selected.
Commit ready rows
Commit reviewed rows. Each committed row inserts a schedule event and, where employees are matched, creates the corresponding assignment.
Review-first: the import safety model
Every import in Yrka is review-first. This means:- Uploads create a batch in review state — no data is applied yet
- All imports generate an admin Inbox work item so the review is tracked
- You commit only after inspecting row previews, employee matching, and validation
- Committing applies ready rows only — rows with errors are skipped, not silently applied
Import history and failed views
Use All history to see every import batch, provider sync job, webhook replay candidate, staged source record, payroll handoff, and notification delivery attempt for your organization. Use Failed to focus on batches and rows that could not commit.Find a failed batch
Open Failed or All history and sort or page the table to find the batch. The status column shows whether the batch failed, needs review, was archived, or succeeded.
Review the failure reason
Open the batch to see the safe error summary. Common causes include unmatched employee identifiers, unsupported columns, and validation conflicts with existing records.
Export skipped or error rows
Export error rows for correction outside Yrka, then re-upload a corrected file. Do not retry a failed batch with the same file if the source data needs correction.
Troubleshooting
Employees do not match in the import preview
Employees do not match in the import preview
Check the employee identifier columns in your file — employee number, payroll ID, email, and name are the supported matching fields. Correct the identifiers in the source file and re-upload. Do not commit rows with unmatched employees if those employees must receive the imported records.
Duplicate rows are flagged
Duplicate rows are flagged
Compare the flagged rows with existing timecards or schedule events in Yrka. If the source data genuinely duplicates what is already in Yrka, skip or do not commit those rows. If they are different records that should both exist, investigate whether the duplicate flag is from a matching identifier conflict.
A file type is blocked
A file type is blocked
Convert the file to a supported CSV, TSV, or ICS format. XLS/XLSX workbook imports are currently disabled — do not attempt to upload workbook files.
Employee invitation emails are not sending after an import
Employee invitation emails are not sending after an import
Check Resend invite readiness in Integrations. Use the manual invite link fallback from Personnel for affected employees until domain and DNS verification are complete.
Resources opens source review instead of an upload form
Resources opens source review instead of an upload form
Resources import is the source review lane, not a file-row mapping lane. To approve and stage source documents for knowledge chat, work through the source review flow in Resources.
The Failed view shows nothing but issues are expected
The Failed view shows nothing but issues are expected
Check All history — the batch may have succeeded earlier or may not have started. The Failed view shows only batches and rows that reached a failed or error state, not pending or in-progress batches.