widget settings

each setting's value is on WS.settings under its key.

text

one-line string.

"hello"

url

URL string.

"https://example.com"

fulltext

multiline string.

"line one\nline two"

code

code string.

"body { color: red; }"

number

number

12

select

the option's value.

"newest"

checkbox

boolean.

true

color

rgb(...) or rgba(...)

"rgb(126, 76, 146)"

date

YYYY-MM-DD.

"2026-08-31"

time

HH:MM (24h).

"18:30"

datetime

YYYY-MM-DD HH:MM.

"2026-08-31 18:30"

image

uploaded image.

{
    file: "cat.png",
    url: "https://widget.st/files/.../cat.png"
}

audio

uploaded audio.

{
    file: "ping.mp3",
    url: "https://widget.st/files/.../ping.mp3"
}

image_set

list of uploaded images. name is optional (used as the custom emoji name if you link this set to an emoji set).

[
    { file: "a.png", url: "https://widget.st/files/.../a.png", name: "happy" },
    { file: "b.png", url: "https://widget.st/files/.../b.png", name: "sad" }
]

emoji

unicode emoji string.

"🌸"

emoji_set

list of emoji ids. unicode is u: + the emoji. custom is c: + the image_set item's name (set custom emojis on the field to an image set).

["u:😀", "c:happy"]

stringset

object of named strings. keys are the option keys you defined.

{
    title: "Leave a comment",
    submit_label: "Post"
}

geo

"latitude, longitude".

"35.6762, 139.6503"

comment

dashboard-only note. not included in WS.settings.