Made in 10Docs
GuidesAPI
Website widget

Icons

The launcher's icon: one of ours, the character's face, or your own logo as an SVG, PNG or WebP.

The pill, icon and tab launchers show an icon. It's one of ours, the character's face, or your own file. You choose it in the deployment's appearance, as launcher.icon.

Ours

Seven icons, drawn in one style (24 × 24 outlines, stroked in the launcher's colour, balanced for a round button):

chat (the default), wave, sparkle, headset, question, mic and play.

launcher.icon
{ "kind": "builtin", "name": "headset", "tint": "#1f5553" }

tint is optional (#rrggbb); it defaults to the text colour on the accent. Our icons follow the theme.

The character's face

launcher.icon
{ "kind": "face" }

The character's face takes the icon's place.

Your own

Upload your logo once, then use its id:

launcher.icon
{ "kind": "upload", "id": "ico_…", "mask": "round" }

mask is none (the default), round or rounded. The file is always fitted whole, then cut by its mask. Another organization's icon, or a deleted one, is 400 invalid_field. Left out entirely, the launcher shows our chat icon.

Upload one

POST/v1/widget-icons

multipart/form-data with one field, file. Answers 201:

201
{ "id": "ico_…", "kind": "svg", "width": 24, "height": 24, "size_bytes": 812,
  "url": "https://talk.madein10.com/api/widget/icons/ico_…", "created_unix": 1793300000 }
curl https://talk.madein10.com/v1/widget-icons \
  -H "Authorization: Bearer $SECRET_KEY" \
  -F "file=@logo.svg"

List and delete

GET/v1/widget-icons

Answers { "data": [ … ] }, newest first.

DELETE/v1/widget-icons/{id}

Answers { "id": "ico_…", "deleted": true }. While a live deployment's launcher shows the icon, it's 409 icon_in_use: change the launcher first.

What's accepted

  • SVG, PNG or WebP, told apart by the file's bytes, never its name.
  • At most 64 KB (413 file_too_large). A PNG or WebP at most 512 × 512. An SVG needs a viewBox (or a width and a height).
  • Anything else is 400 unsupported_file.

An SVG is rebuilt, never kept as sent

We parse your SVG and write it again from a whitelist of shapes: svg, g, path, rect, circle, ellipse, line, polyline, polygon, defs, linearGradient, radialGradient, stop, clipPath, mask, use and symbol, with their geometry and presentation attributes (the style attribute included).

Dropped: every other element and everything in it (<script>, <foreignObject>, <style>, <image>, <a>, animations, text…), every event handler, links to anything but an internal #id, url() to anything but an #id, data: and javascript: values, @import, CSS escapes, comments and processing instructions. A DOCTYPE is refused, and so is nesting deeper than 64 or more than 4,000 elements.

If your logo uses text, convert the text to outlines before you upload it.

How it's served

Each icon is served at its url, by id, to any site:

  • with its image type, X-Content-Type-Options: nosniff and a Content-Security-Policy of default-src 'none'; style-src 'unsafe-inline';
  • with Cross-Origin-Resource-Policy: cross-origin;
  • cached for a year (immutable): an icon never changes, and a new one gets a new id. A deleted one is 404.

The widget shows your file only in an <img> (a browser runs nothing in an image), and only for a launcher style that shows an icon. A site with a Content-Security-Policy needs our address in img-src (Security).

On this page