OneTake Docs
Inventory

AudioDope Import

Import your gear from an AudioDope CSV export, including how categories and insured values are handled.

OneTake can import gear directly from an AudioDope CSV export. The import maps your AudioDope columns to OneTake fields and walks you through a preview — including a category-mapping step — before committing anything.

What gets imported

OneTake maps AudioDope columns to these OneTake fields:

AudioDope columnOneTake field
NameName
CategoryCategory
Replacement costReplacement cost
PhotosPhotos
Insured valueNot imported — see below

Any columns not in this list are ignored. The preview screen shows you exactly which of your columns were matched, which were ignored, and what happened to the insured value column.

Insured values are not imported

AudioDope's insured value column is never brought across. The preview screen tells you this upfront with a banner: "Insured values are not imported."

Your items land with no insured value recorded. Depending on whether a replacement cost was imported, each item ends up in one of two coverage states:

  • Value Unknown — no replacement cost (estimate) was imported for the item.
  • Not Declared — a replacement cost was imported, but there is no insured value to compare it against.

Neither state is a "declared" coverage state. You declare values in one step from the success screen after the import completes — see After the import.

The preview screen

After you drop or select your AudioDope CSV file, OneTake parses it and shows a preview before anything is saved.

Insured-value banner

The banner appears at the top of the preview. It confirms that insured values are not imported and that items will start without a declared insured value.

Column-mapping summary

Below the banner, a "How we'll map your columns" section lists each OneTake field alongside the AudioDope column that matched it. When a column was not found in your file, the field shows . The insured value row is always shown — if the column was present in your file, it shows "Detected — not imported"; if it was absent, it shows .

Any columns in your file that OneTake didn't use are listed under "Ignored columns:".

Row table

All importable rows are shown in a scrollable table. The table has four columns: Row, Name, Category, and Replacement. There is no cap on the number of rows shown — all rows appear, not just the first five.

The insured value column is not shown in the table, even when your file contained that column. The banner carries that message instead.

Skipped rows

When any rows can't be imported, a count appears alongside the valid row count — for example, "3 items ready to import · 1 row will be skipped". A table below the row preview lists each skipped row by row number and the reason it was skipped.

Rows are skipped for two kinds of reasons:

  • Structural problems — the row has more or fewer columns than the header, or contains malformed quotes. OneTake reports these with a clear message, such as "Malformed row — more columns than the header" or "Malformed row — check the quotes around values". The row is skipped; all other rows still import.
  • Missing data — for example, a row with no name.

If your file has structural problems in some rows, fix those rows and re-upload. The skipped-rows table tells you the row number and what was wrong, so you can find them quickly.

Fatal errors

If the file can't be parsed at all — for example, because it has no recognizable name column — the preview shows an error alert instead of the row table. Correct the file and try again.

Mapping categories

AudioDope uses its own category names, which may not match OneTake's fixed category list. After the row preview, a Review category mapping button appears when your file has at least one importable row.

  • When one or more of your AudioDope categories couldn't be matched to a OneTake category automatically, the button label includes a count: "Review category mapping — N need a closer look".
  • When all categories matched cleanly, the button reads "Review category mapping".

Selecting the button expands the category-mapping editor.

How the editor works

The editor lists every distinct category name found in your file. For each one, it shows:

  • The source category name from your AudioDope export (blank categories are shown as (No category)).
  • The number of items using that category.
  • A Needs a closer look badge when a non-blank source category couldn't be matched to a known OneTake category automatically. This is the mismatch the editor highlights.
  • A category picker — the same fixed dropdown used throughout OneTake — showing the automatic match on the right. You can change any row to any canonical category, including Other / Uncategorised.

Rows flagged as needing attention appear first in the list. Rows with clean automatic matches appear below.

What counts as a mismatch

A row is flagged when its source category is non-blank and the automatic match fell back to Other / Uncategorised. A blank source category also defaults to Other / Uncategorised, but is not flagged — that outcome is expected.

Auto-map all

Selecting Auto-map all resets every row to its automatic match, clearing any manual changes you've made in the editor.

Picker uses the controlled vocabulary

The category picker in the editor is the same shared dropdown used on the add-gear form and throughout the app. It only offers the 16 canonical OneTake categories. You can't type a free-form value — every choice is valid. See Equipment categories for the full list.

Collapsing the editor

Select Done mapping categories to collapse the editor. Your choices are kept — they apply when you confirm the import.

How overrides are applied

When you confirm the import, each row's category is set to whatever you chose in the editor. Rows whose category you didn't change use the automatic match. Overrides are applied by exact source category name, so all rows sharing a source category get the same chosen value.

If you choose an override value that isn't a recognized OneTake category (which the picker prevents in normal use), the automatic match is used instead.

Counts shown during the preview

The preview header shows how many items are ready to import and, when applicable, how many rows will be skipped:

SituationText shown
Exactly 1 importable row"1 item ready to import"
Multiple importable rows"N items ready to import"
1 skipped row"· 1 row will be skipped"
Multiple skipped rows"· N rows will be skipped"
No importable rows"No items are ready to import — fix the rows below and pick the file again."

Skipped rows include both structurally malformed rows and rows missing required data such as a name. All skipped rows appear in the skipped-rows table with their row number and the reason.

When there are no importable rows, the commit button is disabled.

After the import

Once you're satisfied with the row preview and category mapping, select Import N items to commit. OneTake imports all valid rows, skipping any with errors, and applies your category choices.

Success screen

When at least one item was imported, the success screen shows a summary and two callouts.

Declare insured values

The "Add your insured values" callout tells you how many items were imported without an insured value — which is always all of them, since insured values are never imported from AudioDope.

The callout includes a Declare insured values button. Selecting it takes you to your Inventory filtered to items in the Value Unknown and Not Declared coverage states — exactly the items waiting on a declared value. From there you can declare values in bulk.

Set up maintenance schedules

When maintenance tracking is enabled for your studio, a second callout — "Keep your gear in shape" — appears below the insured values callout. It suggests adding maintenance schedules to your freshly-imported gear so OneTake can remind you to service it.

The callout includes a See maintenance templates link that takes you to the service-template gallery, where you can pick templates to apply to your new items.

The maintenance callout is not shown when maintenance tracking is not enabled for your studio, regardless of how many items were imported.

If no items were successfully imported, neither callout is shown.

To start over with a different file, select Pick a different file to return to the file drop zone.

Audit log

When the import completes, OneTake writes one entry to the audit log summarising the run. The entry records the filename, the total number of rows, how many succeeded, and how many failed. It appears in the Studio section of the audit log.

The audit write is best-effort — if it fails, your imported items are not affected.

On this page