Location Types
Group storage locations for filtering, cycle counts, and billing.
Use a to group similar storage for filtering, cycle counts, and billing.
Create Location Type
- Open Settings → Location Types (opens the Cybership dashboard in a new tab).
- Click Create Location Type, enter a recognizable name, and click Create.
- Select the type when creating or editing a location. Use Shelf Builder to apply it to generated locations.
Types are categories, not pickability or sellability settings. Configure those flags on the locations themselves.
Storage Billing
Use a published Rate Card storage-pricing rule for the location type. See Charges for billing timing and invoices.
Before deleting a type, reassign its locations and review billing rules that reference it.
Import & Export
Location types support bulk import and export via CSV.
Export
- Navigate to ShipOS → Settings → Location Types (opens the Cybership dashboard in a new tab)
- Optionally apply filters or search
- Optionally select specific types using checkboxes
- Click Export
- Choose the export scope (Selected, Current Page, Search Results, or All)
- The CSV file downloads automatically once processing completes
The export CSV includes the following columns:
| Column | Description |
|---|---|
id | Location type ID |
name | Location type name |
created_at | Date and time the type was created |
updated_at | Date and time the type was last updated |
_lock (Do not modify) | Change detection hash for re-import |
Import
- Navigate to ShipOS → Settings → Location Types (opens the Cybership dashboard in a new tab)
- Click Import
- Upload your CSV
- Import processes asynchronously via background job
| Column | Required | Description |
|---|---|---|
id | No | Existing type ID. If provided, updates the type. If empty, creates a new one. |
name | Yes | Location type name |
created_at | No | Read-only. Ignored on import. |
updated_at | No | Read-only. Ignored on import. |
_lock (Do not modify) | No | Conflict-protection value. Keep unchanged when editing exported rows. |
To add new location types, add rows with both the id and _lock (Do not modify) columns left empty.
Bulk delete is not supported. To remove location types, delete them individually through the UI.
Conflict Protection
Export current records as your starting template. When an export includes _lock (Do not modify), keep its value and the existing row's id unchanged while editing other fields.
- Unchanged rows and edits already matching the saved record are skipped.
- If both the CSV and saved record changed since export, a conflicting edit is rejected. Export the latest data, review the other changes, and reapply your edit.
- A locked row without its original ID is rejected.
- For a new record, leave both the ID and lock empty.
- Omitting a lock on an existing record removes conflict protection; it does not force an otherwise invalid edit to succeed.
Review Results
Wait for the job to finish and inspect created, updated, skipped, and failed rows. A row-based import can partly succeed. Correct failed rows before retrying; do not assume the whole file was rolled back or that repeating new rows is harmless.