> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chemolytic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing samples

> Add, edit, and delete samples manually in your project.

Go to **Samples** in the project sidebar to see all samples.

<Frame>
  <img src="https://mintcdn.com/chemolytic/Z4NdeoejDDDPqHhB/images/screenshots/samples/samples-list.png?fit=max&auto=format&n=Z4NdeoejDDDPqHhB&q=85&s=2c3a86fb57a650359ba0dd8fabf47c63" alt="Samples table showing sample names, property value columns, creation date, and author" width="1714" height="1196" data-path="images/screenshots/samples/samples-list.png" />
</Frame>

## Samples table

The table shows one row per sample. Columns:

| Column                  | Description                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Sample**              | Name and description                                                                                                                                   |
| **\[Property columns]** | One column per property defined in the project. Continuous shows the value with its unit. Categorical shows a colored pill. A dash means no value set. |
| **Created**             | Date the sample was created                                                                                                                            |
| **Author**              | User who created the sample                                                                                                                            |

Click any column header to sort. Use the search box to filter by name or description. Page size can be set to 25, 50, or 100 per page.

## Adding a sample manually

Click **Add sample** to open the create dialog.

<Frame>
  <img src="https://mintcdn.com/chemolytic/Z4NdeoejDDDPqHhB/images/screenshots/samples/create-sample.png?fit=max&auto=format&n=Z4NdeoejDDDPqHhB&q=85&s=a0ea5f9e3b93ab6a391433d7f1155bf4" alt="New sample dialog with name field, description, and property value inputs" width="1714" height="1196" data-path="images/screenshots/samples/create-sample.png" />
</Frame>

### Fields

| Field               | Required | Notes                                                               |
| ------------------- | -------- | ------------------------------------------------------------------- |
| **Name**            | Yes      | Unique within the project. Max 200 characters.                      |
| **Description**     | No       | Free-text. Useful for batch numbers, harvest dates, lot IDs.        |
| **Property values** | No       | One input per property defined in the project. Leave empty to skip. |

### Continuous values

Enter a number. Decimals use a dot (e.g., `12.5`). Anything not parseable as a number is rejected with: "Value '{value}' is not a valid number for continuous property '{name}'."

### Categorical values

Select a category from the dropdown. The dropdown shows the categories you defined for that property, plus a "not set" placeholder.

<Tip>
  You can create a sample with **no property values**. This is useful for samples you've only just measured and haven't analyzed yet. You can fill values in later by editing the sample or via CSV import.
</Tip>

## Editing a sample

Click the pencil icon on a sample row. You can change the name, description, and any property values.

<Warning>
  Editing a sample's property values via the dialog **replaces all of them**. If you only want to update one value, make sure all the others are still filled in (or use CSV import for bulk updates).
</Warning>

## Deleting a sample

Click the trash icon on a sample row.

<Frame>
  <img src="https://mintcdn.com/chemolytic/Z4NdeoejDDDPqHhB/images/screenshots/samples/delete-sample-dialog.png?fit=max&auto=format&n=Z4NdeoejDDDPqHhB&q=85&s=df360d92654fec169d03c6e53b398f59" alt="Delete sample confirmation dialog with type-to-confirm field" width="1714" height="1196" data-path="images/screenshots/samples/delete-sample-dialog.png" />
</Frame>

A confirmation dialog appears. Type the sample name to confirm.

<Warning>
  Deleting a sample also deletes:

  * All its property values (targets)
  * All spectra linked to it
    This cannot be undone.
</Warning>

## Bulk delete

Select multiple samples using the checkboxes on the left. A toolbar appears at the bottom with the count and a **Delete** button.

<Frame>
  <img src="https://mintcdn.com/chemolytic/Z4NdeoejDDDPqHhB/images/screenshots/samples/bulk-delete-toolbar.png?fit=max&auto=format&n=Z4NdeoejDDDPqHhB&q=85&s=caf4202ee35febd9c1ff1e220096dd57" alt="Selection toolbar showing selected sample count and delete button" width="1714" height="1196" data-path="images/screenshots/samples/bulk-delete-toolbar.png" />
</Frame>

Click **Delete**. A confirmation dialog asks you to type all selected sample names separated by commas before deleting. This prevents accidental mass deletion.

## Plan limits

Your plan limits how many samples you can have per project. The current count and limit are shown at the top of the page. The **Add sample** and **Import CSV** buttons are disabled when you've reached the limit.

## Common errors

<AccordionGroup>
  <Accordion title="A sample with this name already exists">
    Sample names are unique within a project. Use a different name or update the existing sample.
  </Accordion>

  <Accordion title="Value is not a valid number for continuous property">
    The value you entered cannot be parsed as a number. Check for typos, units mixed with the value, or commas instead of dots for decimals.
  </Accordion>

  <Accordion title="Value is not in categories for property">
    The value doesn't match any of the categories defined for this property. Categorical values are case-sensitive and must match exactly.
  </Accordion>
</AccordionGroup>
