## TL;DR

The number is outside the field's allowed range. Check the field's min/max (or the picklist of allowed values) and send a value inside the range.

## Error

```text
NUMBER_OUTSIDE_VALID_RANGE
```

## Steps

1. Check the field definition for its range Expected: you know the bounds.
2. Clamp or correct the value Expected: it fits.
3. Re-run the operation Expected: it succeeds.
4. Validate ranges client-side before sending Expected: it cannot regress.

## When to use

- NUMBER_OUTSIDE_VALID_RANGE
- A number violates the field's range

## When not to use

- The value looks fine (then check the field type: percent vs number)
- The range comes from a validation rule (then read the rule)

## Tool compatibility

- Salesforce number fields
- API data loads

## Variant phrasings

### number outside valid range

Check the field's min/max and send a value inside it.

### NUMBER_OUTSIDE_VALID_RANGE

Same: the value violates the field definition.

## Why it happens

Percent fields store 0-100 or 0-1 depending on config, and currency fields have precision limits. Agents guess the scale.

## Edge cases

- Formula fields can also throw this if the formula overflows
- Negative values trip unsigned ranges

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_5Z2kCcgdCjb1ypHUrwG3wg