msx-knowledge-base

Common Misconceptions & Things That Don’t Exist

An anti-hallucination reference. Each entry pairs a plausible-but-wrong assumption with the verified reality. If you are about to output a property, value, action, version, or behavior that resembles a ❌ below, stop and use the ✅ instead. If something you need is not documented anywhere in this KB, say so — do not invent it.

This complements the build-time checklists in AGENTS.md → Common Mistakes and JSON Building Guide → Common Mistakes; here the focus is negative knowledge — what does not exist.


Colors


Inline expressions



Content & layout


Allowed values (enum traps)

These properties accept only a fixed set of values. Common wrong guesses — often CSS habits or generic names — do not exist.


Date / time / duration format tokens

Used in {now:…}, {from:…}, {to:…}, {creation:…}, {duration:…} and {num:…:date/time:…}.


Dictionary file


Right property, wrong object

Many properties are real but only valid on a specific object type. Placing them on a Content Item is a common trap.


Hidden features


Extended properties (the properties bag)


Custom & unknown properties

MSX silently ignores any property it does not recognize, at every object level — so adding custom properties never makes a page invalid, and their presence is not proof that MSX does anything with them. This is not limited to the properties bag above; it applies to top-level object properties too.


Actions


Server actions (execute)


Server responses


Start object, placeholders & URLs


Versioning & compatibility


Plugins


Licensing, authorship & open source


In-app settings


See Also