Add files to a session
Upload spatial files from your device, check their processing status, and resolve common import issues.
You can add files from the upload controls or drag them into the workspace. Before upload, GriidAi separates validated files from invalid files and explains why an invalid file cannot be included. Some formats also show attention items that need a decision, such as a missing companion file. These browser checks catch common problems early; the server performs the authoritative inspection after upload.
Upload from your device
- Open Upload Data in the workspace, or drag files onto the session.
- Choose the files or folders you want to add. For supported formats and any required companion files, see supported formats.
- Review the file groups. Resolve missing companion files or other attention items where possible. Items that cannot be uploaded show why they are not included.
- If an existing item has the same name, choose whether to skip, rename, or replace it when those options are available. Replacing requires confirmation.
- Upload the files and wait for processing to finish. If a file needs attention—for example, its coordinate system cannot be identified—follow the requested action. Do not guess a CRS; assign one only if you know what the source coordinates mean.
- The item appears in the catalog when it is ready.
You may also drop files into the assistant composer when you want to upload data and describe a task in the same conversation. Check that the upload completed before asking the assistant to analyze it.
Choose Zarr variables and slices
A Zarr store can contain several variables and dimensions, such as time, depth, or level. Choose the complete store from your device, keeping its folder structure and metadata together.
- Add the store through the upload controls and wait for its variables to be inspected.
- Select a variable you want to import. Choose the available time, depth, or other dimension values for that variable.
- For a large dimension, use the index-range controls shown in the selector. Check the displayed values so that the range matches the period or levels you need.
- Select Apply selection for each variable. An unapplied selection must be applied or cancelled before you can upload.
- Review the selected variables and expected outputs, then start the upload. Follow any selection or output-limit messages shown in the form.
Selected variables and slices can produce several raster layers. Check the imported layer names, dates, units, and coverage before using them in an analysis. If the store cannot be inspected, review the error; you can skip that store and continue with other valid uploads.
Organize your data
Use the catalog to search, filter, rename, move eligible items into folders, and remove items you no longer need. Catalog capabilities can differ for shared, temporary, or read-only items.
Upload size and storage limits depend on your account and current plan configuration. Check the app's plan or storage information for the limits that apply to you. If an upload stalls, see troubleshooting.
Resolve a matching name
If a dataset name is already in use, review the choices shown for that upload group:
- Skip leaves the existing item in place and omits the incoming dataset.
- Rename lets you keep both datasets under different names. Keep companion files together when renaming a grouped dataset.
- Replace existing, when offered, updates the existing item after the new upload is validated and published. Confirm that you intend to replace it before continuing.
Replacement is not available for every upload. Archives and other uploads that create several outputs may offer different choices. Use the options shown for the group rather than deleting the existing item first.
Prepare for a large upload
Keep the browser tab open while files are being prepared and transferred. Preparation may use temporary storage on your device, so leave enough free space for large files or archives. If progress stalls, read the warning shown for the upload before cancelling or restarting it.
For folder organization and removing items, see manage catalog items.
Need assistance with this workflow?
Our geospatial engineering team is available to help with custom datasets, STAC queries, and algorithms.