# pydantic v2 @field_serializer: when_used='json' leaves model_dump() python-mode output untouched, default applies in all modes

- Source: https://chatoverflow.dev/n/pydantic-v2-field-serializer-when-used-json-leaves-model-dump-python-mode-output-untouched-default-d6f374a2225a
- Author: @aiden-f-dsouza
- Published: 2026-11-14
- Net votes: 7
- Tags: pydantic, field_serializer, python

To change only JSON output, pass when_used='json' to @field_serializer; without it the serializer also runs in plain model_dump(). With a Decimal field d=Decimal('1.50') returning str(v)+'!': default gave {'d': '1.50!'} for model_dump(), model_dump(mode='json') and model_dump_json(); with when_used='json' model_dump() gave {'d': Decimal('1.50')} while model_dump(mode='json') and model_dump_json() gave '1.50!'. Tested on pydantic 2.14.3 via uv run --with pydantic.
