Deprecations
Surfaces on the way out, and the version they'll be removed in.
Cartisto deprecates rather than silently removing. A deprecated surface keeps working until the next major version of its contract, and the Quality Gate warns when a theme uses one.
How a deprecation works
- A surface is marked deprecated and listed here with its removal version and a replacement.
- It keeps working for the rest of the current major.
- The gate emits a warning on use (not a failure — your theme still publishes).
- At the next major, it’s removed, and the gate turns the warning into an error for themes targeting that major.
Currently deprecated
None while the contract is pre-launch — during this phase old surfaces are deleted and their replacements adopted in the same change, rather than carried as deprecations.
Once the contract freezes at v1, this page tracks every deprecation with:
| Surface | Deprecated in | Removed in | Replacement |
|---|---|---|---|
| (populated at launch) |
Note
Pre-launch is different on purpose Before launch there is no back-compat: a better name or shape replaces the old one immediately. That freedom ends at launch — after which this page is the contract for how anything goes away.