Index of every page on this site: llms.txt
All skills
wix avatar

/wix-manage

@e2bc48e official
by Wix.comwix/skills40 stars
42
Run it yourself

REST recipes to configure and manage a Wix site's business solutions — stores, bookings, donations, payments, CMS, and more — and to publish HTML, CSS and JavaScript files as a live Wix site, with or without a Wix account. Open the matching recipe for the exact endpoint, method, and payload before calling — never guess a Wix API, never write Wix dashboard URL from memory. Routes to: automations, stores, bookings, donations, get-paid, CMS, contacts, forms, media, app-installation, custom-apps, pricing-plans, restaurants, ricos rich-content, sites, collaborators, studio-workspace, blog, calendar, domains, events, site-properties, ecommerce, marketing, online-programs, google-ads, google-business-profile, analytics, accessibility, seo, dashboard-navigation.

Use this Skill: https://skilld.dev/gh/wix/skills/wix-manage

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesautomationsbracket-expressions.md

≈4.7k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Bracket Expressions (Formulas) — {{…}}

TL;DR

  • {{expression}}; fields via var("dotted.path") (double quotes, one argument); arguments separated by ;; string literals in double quotes and URI-encoded.
  • In formula fields (action inputs, set-variable values, delay due dates) use ONLY the builder function list in §2. Conditions and trigger filters have their own, stricter vocabularies — Automations Conditions, Automations Trigger Configuration §4.2.
  • The builder type-checks every argument and the arity (§2): eq/gt/gte/lt/lte take NUMBERS only (strings → stringEq, dates → date*); if()'s first argument is boolean. There are no operators.
  • No array element access in any form. Project with arrayMap(array;"path"), aggregate with array*. A scalar cannot be indexed directly from an array; use the extraction fallback in §5 when needed.
  • Only data from the step's aggregated schema (trigger + ancestors) is in scope (Automations Graph and Data Model §4).

1. Syntax

Form Example
Literal {{"text"}}, {{10}}, {{true}}, {{["a","b"]}}
Variable {{var("contact.name.first")}}
Function {{concat(var("a");"%20-%20";var("b"))}}
Text with embedded expressions (string fields only) Hi {{var("contact.name.first")}}, your total is {{toString(var("total"))}}

MUST:

  • Every field access is var("path") with ONE argument — {{fieldName}} is not supported.
  • Double quotes only (var('x') is an unknown variable to the builder). In JSON escape them: "{{var(\"contact.email\")}}".
  • ; between arguments, no leading/trailing/double ;, balanced parentheses. No whitespace outside string literals — {{ concat(… or sum( 1;2) is unreadable to the builder.
  • Numbers: plain decimal literals (5, -3, 12.5, 0.5, -0.25). Include the zero before the decimal point; .5, leading zeros such as 05, and exponent notation such as 1e3 are invalid. For 10% of x, multiply(x;0.1) and divide(x;10) are equivalent. Timing panels impose separate whole-number limits (Automations Delays Variables and Branches).
  • Path segments may contain hyphens (var("triggered-emails-1.messageId")); a space inside a segment is invalid.
  • URI-encode every string literal inside {{…}} exactly as encodeURIComponent does — this is how the builder's panels and the platform store them: "a@b.com" → "a%40b.com", "50%" → "50%25", "New York" → "New%20York", "&" → "%26". Letters, digits and - _ . ! ~ * ' ( ) stay as they are, so uuids and arrayMap paths are unchanged. Do NOT encode var("…") paths (except in trigger filters, where the filter panel encodes the path too — Automations Trigger Configuration) or text outside {{…}}, nor a date-time literal in a formula field (§2). Decode literals when you read an existing automation. Action formula fields display literals as stored, so in string fields keep fixed text outside {{…}} (Hi {{var("contact.name.first")}}, welcome!) rather than in concat("…").

Prefix rules: trigger fields have no prefix; action outputs "<namespace>.<field>" (namespace = the step's namespace, e.g. createTask-1); set variables "setVariable.<key>"; identity enrichment "contact.…" / "member.…". siteInfo.* is not available — don't reference it.

2. Functions the builder renders in formula fields (complete list)

  • Math: sum(n;n;…) · subtract(n;n) · multiply(n;n;…) · divide(n;n) · average(n;…) · min(n;…) · max(n;…) · median(n;…) · mod(n;n) · round(n;decimals) · abs(n) → number · eq(n;n) · gt(n;n) · gte(n;n) · lt(n;n) · lte(n;n) → boolean (numbers only)
  • Array: arraySize(a) · arraySum(a) · arrayMultiply(a) · arrayAverage(a) · arrayMin(a) · arrayMax(a) · arrayMedian(a) → number · arrayMap(a;"item.path") → array
  • Text: concat(s;s;…) · substring(s;start;length) (0-based) · lower(s) · upper(s) → string · stringLen(s) → number · stringEq(a;b) · stringHasSubString(s;sub) · startsWith(s;prefix) · endsWith(s;suffix) · isEmptyString(s) → boolean
  • Date: hour(dt) · minute(dt) · year(d) · month(d) · day(d) → number · weekDay(d) → lowercase day name · dateEq/dateBefore/dateAfter(d;d) (calendar date) · dateTimeEq/dateTimeBefore/dateTimeAfter(dt;dt) → boolean · addToDate(d;years;months;days) · subtractFromDate(d;years;months;days) → date-time · now() → date-time string
  • Format: toString(v) → string · toNumber(v) → number
  • Logic: if(bool;then;else) · and(b;b;…) · or(b;b;…) · not(b) · isEmpty(v) (any value, incl. arrays) → boolean (if → its branches' value)

isEmpty(v) is true for a missing value, null, "", [] or {}; it is false for a non-empty string, whitespace-only string, 0 or false. It alone covers missing/null/empty-string fallbacks; adding isEmptyString(v) with or is valid but redundant.

Arity (write exactly these counts; the builder flags missing and extra arguments for fixed-arity functions): var, not, toString, toNumber, upper, lower, stringLen, abs, isEmptyString, isEmpty, every array* aggregate = 1 · comparisons, round, subtract/divide/mod, arrayMap = 2 · if, substring = 3 (always pass the length) · addToDate/subtractFromDate = 4 · now = 0 · and/or/concat/sum/multiply ≥ 2 · min/max/average/median ≥ 1.

Argument types the builder enforces (convert with toString()/toNumber()):

Parameter Accepts
number (math, comparisons, substring offsets, date offsets) number literal, number/integer var, number-returning function; wrap a string format: number var (money values) in toNumber() — the platform rejects it bare
string (text functions, concat) string literal/var/function — never a number or boolean (wrap in toString())
boolean (if arg 1, and, or, not) comparison, boolean var, isEmpty/isEmptyString/startsWith/…
date (year, month, day, weekDay, dateEq/Before/After, addToDate…) a var whose schema has format: date or date-time, a "YYYY-MM-DD" literal, or a function (now(), addToDate(…))
date-time (hour, minute, dateTimeEq/Before/After) a var with format: date-time, a function, or an ISO date-time literal — a format: date var or plain-string var is rejected
array (array* functions, isEmpty) array var or arrayMap(…); no other function takes an array argument

An encoded date-time literal ("2026-12-25T10%3A00%3A00Z") is not recognized as a date in a formula field — pass a "YYYY-MM-DD" literal or a function, or make the whole field a plain ISO value (§4). This exception is for formula fields only: in a CONDITION the panel itself writes date-time literals encoded and reads both forms (Automations Conditions §2).

Semantics: stringEq and stringHasSubString are case-insensitive (normalize with lower() if it matters). Booleans: use the value directly (if(var("isVip");…), not(var("isVip"))), never eq(var("isVip");true).

Never use in a formula field (the builder flags them as unknown functions): toEpoch, arrayFilter, hasSubstring, textWithExpressions, contains, arraySome, arrayEvery, arrayIncludesAnyOf/AllOf/Only, stringContains, numberContains, boolEq, numberEq/numberGt/numberGte/numberLt/numberLte. (Several of these ARE the condition vocabulary — Automations Conditions §2 — and contains/arraySome the trigger-filter vocabulary.)

Do not exist (never guess): replace, replaceAll, trim, split, join, indexOf, regex/match, ceil, floor, parseInt, parseFloat, random, filter, reduce, sort, switch, loops, try/catch, coalesce, formatDate, formatNumber, formatCurrency, titleCase, add, addDays, equals.

3. if() needs a boolean first argument

Valid first arguments: a comparison (eq, gt, stringEq, dateBefore, startsWith, …), a genuinely boolean field, or and/or/not/isEmptyString/isEmpty.

In number and boolean target fields BOTH branches must return exactly the field's type — a number literal/var/function for a number field. A nested if as a branch counts as "any" and is flagged there: wrap it (toNumber(if(…))) or, for booleans, use and/or. Nested if is fine in string fields.

  • ✅ {{if(stringEq(var("status");"active");"Active";"Inactive")}}
  • ✅ fallback when the value is missing or empty: {{if(or(isEmpty(var("contact.name.first"));isEmptyString(var("contact.name.first")));"there";var("contact.name.first"))}}
  • ❌ {{if(var("status");…)}} when status is a string · ❌ {{if("active";…)}}

4. Field-type rules (what the builder accepts per target field)

  • string — Plain text, one expression, or text mixed with any number of {{…}}; no expression may return an array.
  • number / integer (incl. string format: number) — Exactly ONE {{…}} covering the whole value, returning a number — or a plain number literal. No surrounding text.
  • boolean — Exactly ONE {{…}} returning boolean — or true/false.
  • date / date-time — A plain ISO literal without {{}} (2026-12-25T16:00:00Z), or ONE expression: a function (now(), addToDate(…)) or a var. For a date-time field the var must be format: date-time — wrap a format: date var as addToDate(var("d");0;0;0).
  • array / object — A literal array/object built field by field, or one {{var("…")}} of the same shape.
  • field without dynamicValuesOptions.enabled in the UI schema — Literal only — no {{…}} (Automations Action Configuration §3).

A strict dynamic field requires the exact return type/format. skipActionExpression is "{{true}}" or absent.

5. Arrays — hard limits

  • No element access: var("items[0]"), var("items.0.name"), var("items[0].name") are all invalid. Don't invent firstItem/items.id helper paths either.
  • Projection: {{arrayMap(var("order.items");"product.name")}} — second argument is a quoted literal path (never $_ or an expression).
  • Aggregates: {{arraySize(var("lineItems"))}}, {{arraySum(arrayMap(var("lineItems");"totalPrice.value"))}}. Never arraySum(var("items.price")) — a path cannot cross an array boundary.
  • No per-element arithmetic in formulas (price × quantity): sum a verified per-line total field if one exists. If the result only decides a branch, use a code condition (Automations Conditions §5). Otherwise formulas cannot compute it exactly; explain the limitation. Use Generate or Analyze Text for a computed value only after the user accepts an AI-derived, potentially approximate result and its current input contract can carry all required data. Do not silently replace exact arithmetic with model output.
  • No lists as text: no join; an arrayMap result can't go into concat or a string field.
  • Scalar extraction needs a separate step. If the source is an array, a Generate or Analyze Text step can return a named scalar only when its current input contract provides a verified way to supply all required source data (Automations Delays Variables and Branches §4). A scalar prompt cannot take a raw array-returning expression; use a verified serialized-text source, not a guessed context field or unverified array conversion. Then map the named ancestor output. SET_VARIABLES alone cannot extract an element. A verified single-item data source or a user-supplied value is another option. Ask only when which item to select is a business ambiguity; do not label the whole task impossible because formulas cannot index the array.
  • Empty arrays make arraySum/arrayMin/arrayMax/arrayMedian/arrayMultiply fail at runtime.
  • Membership tests (does the order contain X) belong in a condition (Automations Conditions §3) or, for complex logic, a code condition.

6. Dates

  • date* compare calendar dates, dateTime* instants (argument formats: §2). addToDate/subtractFromDate offset by whole years/months/days.
  • "Within N days before X": {{dateAfter(var("d");subtractFromDate(var("x");0;0;7))}}. Day differences can't be computed renderably (no toEpoch) — use a DELAY, such a comparison, or a code condition.
  • Annual dates (birthdays): never dateEq(var("birthdate");now()). Compare month and day: {{and(eq(month(var("contact.birthdate"));month(now()));eq(day(var("contact.birthdate"));day(now())))}} — in a formula field; as a condition use code or a boolean set-variable (Automations Conditions §4).
  • Never hardcode a year; derive it: {{dateAfter(var("order_date");concat(toString(year(var("order_date")));"-10-31"))}}. Use year(now()) only when the rule is about the current calendar year.
  • Windows crossing New Year (Dec 26 – Jan 4): {{or(and(eq(month(var("d"));12);gt(day(var("d"));25));and(eq(month(var("d"));1);lt(day(var("d"));5)))}}; pick gt/gte from the user's wording.
  • Formatting: {{toString(month(var("d")))}}/{{toString(day(var("d")))}}/{{toString(year(var("d")))}} in a string field.

7. Conversions

toString() numbers/booleans before text functions; toNumber() string format: number fields before math; neither converts arrays.

8. Workarounds that stay renderable

  • Strip a known prefix: {{if(startsWith(var("price");"%24");substring(var("price");1;subtract(stringLen(var("price"));1));var("price"))}} ("%24" is the encoded "$").
  • Title case: {{upper(substring(var("t");0;1))}}{{lower(substring(var("t");1;subtract(stringLen(var("t"));1)))}}.
  • For replace/split/regex/loops, use a code condition when the result is only a branch decision. For a value consumed downstream, prefer a verified data source. Use Generate or Analyze Text (Automations Delays Variables and Branches §4) with a named, typed output only when its current input contract can carry all required source data. For computed values, disclose that the model result may be approximate and obtain the user's agreement before substituting it for exact computation. If no supported path provides the needed value, explain that specific blocker.

9. Self-validation checklist (run on every expression)

  1. Parses: balanced {{}} and parentheses, ; separators, double-quoted strings, no whitespace outside strings, plain decimals such as 0.5 and -0.25 are valid; no omitted zero (.5), integer leading zeros (05) or exponent notation.
  2. Every function is in §2 (formula fields), the condition table (conditions) or the filter shapes (filters).
  3. Arity matches §2 exactly (substring 3, round 2).
  4. Argument types match the §2 table: numbers to math/eq/gt…, strings to text functions (toString numbers), dates with the right format, arrays only to array*/isEmpty; if arg 1 boolean and, in number/boolean fields, both branches of the field's type; arrayMap arg 2 a literal path.
  5. Every var() path exists in the aggregated schema of THIS step (ancestors only). If the unknown path has an array prefix (items.id where items is an array), element access is inexpressible in a formula — don't respell the path; use the §5 extraction fallback, or ask which item when that is a business choice.
  6. $_ appears only inside arraySome/arrayEvery predicates (conditions/filters), bare (never var($_) or $_.x).
  7. Result type fits the target field (§4); no array into a single-value field.
  8. String literals URI-encoded; no single quotes.
  9. Final gate: Validate Automation returns no mapping errors — it misses some paths and every builder-only rule above, so steps 1–8 are yours.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 alerttoday4 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    The skill is a comprehensive management tool for Wix sites. It contains potential security risks such as an indirect prompt injection surface from site scraping and the ability to define JavaScript-based automation logic, but it includes strong requirements for user confirmation before any site changes.

  • Sockettoday

    No alerts

  • Snyk1d

    Risk: CRITICAL · 3 issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at e2bc48e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 4 days ago
compatibility
Requires Wix REST API access (API key or OAuth).
  • wix
  • rest-api
  • ecommerce
  • bookings
  • cms
  • contacts
  • blog
  • domains
  • restaurants
  • site-configuration
  • api-integration

README badge

README badge for wix/skills/wix-manage

REST API operations for configuring Wix business solutions including stores, bookings, CMS, contacts, domains, and ecommerce. Routes to site setup, entity management (products, services, staff), bulk administrative operations, and server-to-server integrations across Wix's business app ecosystem.

Generated from the current SKILL.md.

Do I need API credentials to use these recipes?
Yes. The skill requires Wix REST API access via either an API key or OAuth token to execute any management operations.
Can I use these recipes to display data on my site frontend?
No. These recipes are for backend REST API operations only — site configuration, entity management, and administrative tasks. They do not cover frontend development or displaying data to users.
What business domains do these recipes cover?
The skill covers stores, bookings, payments, CMS, contacts, forms, media, apps, pricing plans, restaurants, rich content, sites, blogs, calendars, domains, and site properties.
Do these recipes handle OAuth authentication with external services like Google Calendar?
Yes. The external calendar integration recipe covers OAuth-based setup with Google Calendar, Microsoft Outlook, and Apple Calendar for bidirectional event sync.

Generated from the current SKILL.md. These answers refresh after source changes.