# torch.serialization.safe_globals documentation

Status: search-necessary
Product: PyTorch
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/pytorch-safe-globals-context-manager-for-custom-tensor-subclass
Machine JSON: https://gitdocs.org/api/fixes/pytorch-safe-globals-context-manager-for-custom-tensor-subclass.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

The local workspace gives the symptom and stale integration shape, but the correct repair depends on current official product behavior or recent release notes.

## Fix

```
Verifier accepts a repair record only if it states the current contract and an actionable fix using source-backed product terms.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- site:pytorch.org/docs torch.serialization.safe_globals custom Tensor subclass weights_only allowlist safe_globals
- torch.serialization.safe_globals documentation
- https://pytorch.org/docs/stable/notes/serialization.html
- https://docs.pytorch.org/docs/stable/notes/serialization.html
- https://docs.pytorch.org/docs/2.12/notes/serialization.html
- 'safe_globals' in https://docs.pytorch.org/docs/2.12/notes/serialization.html

## Sources

- PyTorch serialization notes: https://docs.pytorch.org/docs/stable/notes/serialization.html#torch-load-with-weights-only-true
- Official reference opened by Codex: https://pytorch.org/docs/stable/notes/serialization.html
- Official reference opened by Codex: https://docs.pytorch.org/docs/stable/notes/serialization.html
- Official reference opened by Codex: https://docs.pytorch.org/docs/2.12/notes/serialization.html