These pages list the exact data fields available to hosted Vascula themes. Add a root name such as product to a section's ctx_needs, then read it directly as product.title in the template. The ctx. prefix shown here identifies the public contract; do not include that prefix in a Vascula expression. Required fields are present whenever their containing object is present. Optional fields may be absent, and nullable fields may be present as null. [] marks an array item and {key} marks a key selected at runtime. Named types such as Price and Media are detailed on Shared data shapes.
ctx.customer#
The signed-in shopper and, when requested, their account addresses, orders, and routed receipt. Loaded when a section declares it in ctx_needs.
Field |
Type |
Requirement |
|---|---|---|
|
Object |
Declared root |
|
Boolean |
Required |
|
URL |
Required |
|
Object |
Optional |
|
Object |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Boolean |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
String |
Required |
|
Object |
Optional |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Object |
Optional |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Array of object |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Optional |
|
Object keyed by name |
Required |
|
Object |
Dynamic key |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Object keyed by name |
Required |
|
Object |
Dynamic key |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Object keyed by name |
Required |
|
Array of object |
Dynamic key |
|
String |
Required |
|
String |
Required |
|
Object keyed by name |
Required |
|
String |
Dynamic key |
|
Object |
Optional |
|
Boolean |
Required |
|
Array of object |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Boolean |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Integer |
Required |
|
Integer |
Required |
|
Integer |
Required |
|
String |
Required |
|
String |
Required |
|
Object |
Required |
|
URL |
Required |
|
Array of object |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Integer |
Required |
|
String |
Required |
|
Array of object |
Required |
|
Boolean |
Required |
|
URL |
Required |
|
String |
Required |
|
Timestamp |
Required |
|
String |
Optional |
|
String |
Required |
|
String |
Required |
|
Boolean |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Boolean |
Required |
|
URL |
Required |
|
Object |
Optional |
|
Address or null |
Required; may be null |
|
Boolean |
Required |
|
String |
Required |
|
Object |
Required |
|
String |
Required |
|
String |
Required |
|
Timestamp |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
String |
Required |
|
Timestamp |
Required |
|
Timestamp |
Optional |
|
String |
Required |
|
Array of object |
Required |
|
String |
Required |
|
Timestamp |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
String |
Required |
|
Integer |
Required |
|
Timestamp |
Optional |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
Presented money |
Optional |
|
Presented money |
Required |
|
Presented money |
Required |
|
Integer |
Required |
|
String |
Required |
|
Boolean |
Required |
|
String |
Required |
|
String |
Required |
|
Integer or null |
Required; may be null |
|
URL |
Optional |
|
Integer |
Required |
|
Integer |
Required |
|
Boolean |
Required |
|
Object |
Optional |
|
Integer |
Required |
|
Boolean |
Required |
|
Integer |
Required |
|
String |
Required |
|
Integer |
Required |
|
Presented money |
Required |
|
Presented money |
Required |
|
String |
Required |
|
Presented money |
Required |
|
String |
Required |
|
Presented money |
Required |
|
Presented money |
Required |
|
Integer or null |
Required; may be null |
|
String |
Required |
|
String |
Required |
|
Object |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Decimal string |
Required |
|
Object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Decimal string |
Required |
|
Presented money |
Required |
|
Array of object |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Presented money |
Required |
|
Integer |
Required |
|
Integer |
Required |
|
Integer or null |
Required; may be null |
|
Presented money |
Required |
|
String or null |
Required; may be null |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Object |
Required |
|
String |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
String |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Integer |
Required |
|
Integer |
Required |
|
String |
Required |
|
Integer or null |
Required; may be null |
|
Boolean |
Required |
|
Presented money |
Required |
|
Presented money |
Required |
|
Object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Decimal string |
Required |
|
Presented money |
Required |
|
Object |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Array of object |
Required |
|
String |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Decimal string |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Decimal string |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Decimal string |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Decimal string |
Required |
|
Presented money |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Address or null |
Required; may be null |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
Presented money |
Required |
|
String |
Required |
|
Integer |
Required |
|
Object |
Optional |
|
Boolean |
Required |
|
Array of object |
Required |
|
String |
Required |
|
Timestamp |
Required |
|
Object |
Optional |
|
Presented money |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Object |
Required |
|
String |
Required |
|
String |
Required |
|
Presented money |
Required |
|
Integer |
Required |
|
String |
Required |
|
Integer |
Required |
|
Array of object |
Required |
|
Boolean |
Required |
|
Integer |
Required |
|
URL |
Required |
|
Integer |
Required |
|
Integer |
Required |
|
String |
Required |
|
String |
Required |
|
Object |
Required |
|
URL |
Required |
|
Array of object |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
Array of object |
Required |
|
Integer |
Required |
|
String |
Required |
|
Boolean |
Required |
|
String |
Required |
|
URL |
Required |
|
Integer |
Required |
|
Integer |
Required |
|
String |
Required |
|
Boolean |
Required |
ctx.customer_settings#
Storefront-safe account, sign-in, registration, consent, and customer feature settings. Loaded when a section declares it in ctx_needs.
Field |
Type |
Requirement |
|---|---|---|
|
Object |
Declared root |
|
String |
Required |
|
URL |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
String |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Integer |
Required |
|
Boolean |
Required |
|
Integer |
Required |
|
Boolean |
Required |
|
URL |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
Boolean |
Required |
|
String |
Required |
|
URL |
Required |
|
URL |
Required |
|
Boolean |
Required |
|
Array of object |
Required |
|
String |
Required |
|
Boolean |
Required |
|
Boolean |
Optional |
|
Boolean |
Required |
|
Boolean |
Required |
|
Integer |
Required |
ctx.phone_countries#
Localized phone country options allowed by the store's customer settings. Loaded when a section declares it in ctx_needs.
Field |
Type |
Requirement |
|---|---|---|
|
Array of object |
Declared root |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
|
String |
Required |
ctx.forms#
Hosted-action field requirements and length or media limits. Loaded when a section declares it in ctx_needs.
Field |
Type |
Requirement |
|---|---|---|
|
Object |
Declared root |
|
Object |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Boolean |
Optional |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Boolean |
Optional |
|
Integer |
Optional |
|
Boolean |
Optional |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
|
Object |
Required |
|
Integer |
Optional |
|
Integer |
Optional |
|
Boolean |
Required |
ctx.auth_form#
Safe hosted-auth form replay state after a submission. Available after the related hosted action redirects back with a result. Declare it in ctx_needs before reading it.
Field |
Type |
Requirement |
|---|---|---|
|
Object |
Declared root |
|
String |
Optional |
|
String |
Optional |
|
String |
Optional |
|
String |
Optional |
|
String |
Optional |
|
String |
Optional |
ctx.form_error#
A localized validation error returned by a hosted form. Available after the related hosted action redirects back with a result. Declare it in ctx_needs before reading it.
Field |
Type |
Requirement |
|---|---|---|
|
Message |
Declared root |
ctx.auth_notice#
A localized sign-in or registration status message. Available after the related hosted action redirects back with a result. Declare it in ctx_needs before reading it.
Field |
Type |
Requirement |
|---|---|---|
|
Message |
Declared root |
ctx.form_notice#
A localized post-redirect result from a hosted storefront action. Available after the related hosted action redirects back with a result. Declare it in ctx_needs before reading it.
Field |
Type |
Requirement |
|---|---|---|
|
Object |
Declared root |
|
String |
Required |
|
String |
Required |
|
Boolean |
Required |