Widget reference

How the catalog is organised

Widgets are added from a popup called Add a widget. You open it by tapping an empty cell on the editor canvas — there is no plus button in the toolbar. The editor covers the canvas gestures; this chapter covers what is inside the popup.

1. 1Tap an empty cell. The widget lands at that cell if it fits.
2. 2Optionally type in Search widgets…. It matches a widget's name, its one-line description and its internal type name. On a phone the field does not autofocus, so the keyboard never covers the grid.
3. 3Optionally change the order with the Sort widgets button.
4. 4Pick a category tab.
5. 5Tap a tile. The widget is added and the popup closes.

The tabs

• All — 97 tiles: every widget the popup offers, plus one shortcut tile per social platform.
• Profile — 11 widgets about you.
• Social — 10 app-icon shortcuts that add a Social Link already set to that platform.
• Content — 14 widgets that hold your words, photos, video and links.
• Interactive — 8 widgets a visitor can use.
• Shop — 6 widgets about money and services.
• Personality — 3 widgets about who you are.
• Layout — 6 widgets that shape the page rather than fill it.
• Explore — 12 toys, games and page decoration.
• Store — free widgets other creators published to the marketplace.

Under the grid, a progress bar counts your collection: You've used so many widget types out of 64. That 64 counts every widget type the app knows about, including the three the popup never offers — Pocket Pet, custom widgets, and the original Profile (replaced by Portrait and Bio, and still shown on pages that already use it). The All tab's 97 tiles are a different count: it drops those three and gives each social platform its own shortcut.

Sort and badges

• Name — A to Z. The default.
• Size — biggest default footprint first.
• Recently used — what you added most recently, remembered in this browser only, up to sixteen entries. It does not follow you to another device.

Each tile carries a size badge in its top-right corner, like 2×2. A small purple dot in the top-left, tooltip Not on your page yet, marks a type this page does not have.

The Store tab

The Store tab lists widgets other people built and published, filtered to the free ones. It shows Loading… while it fetches. Tap a card to install it; you get Widget added. Paid widgets are bought from the Store tab of the app itself — see The marketplace.

The Edit Widget sheet

Every widget is configured in the same place. Tap a widget on the canvas to select it, then tap the pencil at its top-right corner, tooltip Edit widget. A half-height card titled Edit Widget slides up from the bottom.

Close it with the close button, the Escape key, your browser's back gesture, or by swiping the header strip downwards.

What is in every sheet, top to bottom

• The header — the widget's icon, its name, and a trash button that deletes it.
• Size — three chips: compact, medium, large.
• Go to link — appears only when the widget holds a real web address. Opens it in a new tab.
• Rewrite — free AI rewording, on widgets that hold text you wrote.
• Publish this widget — lists this one widget in the marketplace. Élégante only.
• The widget's own settings — the bulk of this chapter.
• Effects and Shape mask — the look of the tile itself.

Size

The three chips each show their exact footprint underneath, like 2×1. One tap applies it. Widgets whose presets are all the same span show fewer chips — Spacer and custom widgets show none at all, because there is only one size to pick.

• A widget is added at its compact span.
• You cannot shrink it below compact, by chip or by drag. That floor is the smallest size at which its own content is still readable.
• A widget has to fit in both the phone and the desktop canvas. If either is full, it is not added.
• Phone and desktop remember separate positions and sizes for the same widget.

Effects and Shape mask

Effects is a grid of seven: None, Shadow, 3D Depth, Glow, Outline, Glass, Inset. Three of them add a sub-control — a colour, a direction, an intensity or a border width.

Shape mask clips the whole tile to a shape: None, Blob, Pebble, Hexagon, Star, Arch, Squircle. It needs a paid plan Élégante. Style and effects goes through both in detail.

Rewrite and Assist

Rewrite is a pill near the top of the sheet. Tap it, type what you want changed — the placeholder suggests make it shorter — and press Enter or tap Go. It rewords every text field in that widget at once. It costs no credits, and undo puts the old wording back.

Eight individual fields also carry a small Assist pill, which rewrites just that field and does cost credits: Title and Bio on Profile, Description (optional) on Product, Content on Text, Quote on Quote, Subtitle (optional) on Section header, Text (separate items with •) on Marquee, and Subtext (optional) on Subscribe. No other field has one. Two of the eight also offer a Translate… mode — Content on Text and Text (separate items with •) on Marquee. AI assists and credits covers costs, caps and modes.

Publish this widget

This lists the selected widget in the marketplace for other people to install. The pill only appears on a paid plan Élégante.

1. 1Tap Publish this widget. A dialog opens: List it in the marketplace for others to install..
2. 2Fill in the form. The title starts as My widget and the confirm button stays disabled while it is blank.
3. 3Confirm. The button reads Save draft when the listing is a draft and Publish otherwise.

You get Widget published or Saved as a draft listing. Selling is covered in Selling and payouts.

The shared field types

• Colour pickers — a swatch that opens a picker with a hex box. Leaving one unset means "use the widget's own default", and a small ✕ next to the swatch clears it.
• Image fields — either a picker with a placeholder image, an Upload your own image button and Choose from Files; or a single Insert image / Replace image button. Uploaded photos go through the crop and filter editor first, except GIFs, which skip it so the animation survives.
• The media picker — a sheet titled Insert image (or Insert video) with two segments: Upload from your device and Your files from your library.
• Sync fields — a web address plus a Sync button, on Latest Posts, Bookshelf and Film Log. Imported entries stay editable, and you can re-sync any time.

Profile widgets

The ten widgets in the Profile tab are the ones that say who you are.

The Social Link widget

The Social tab's ten app icons all add the same widget, pre-set to that platform. Once it is on your page it supports sixteen: Website, X / Twitter, Instagram, GitHub, LinkedIn, YouTube, TikTok, Dribbble, Spotify, Twitch, Bluesky, Mastodon, Discord, Reddit, Telegram and Email.

Sizes: 1×1 · 1×1 · 2×2.

Four ways to show one link

• Icon — just the platform glyph. The default.
• Button — a labelled row with your handle.
• Stat — a follower-style number with a label and an optional growth line.
• Post — a card with an image, a title, a meta line and an optional play badge.

Live data

Some platforms can fill the stat and post fields with real numbers and keep them fresh. Eight of them work by typing your handle and pressing Fetch (Refresh once connected): YouTube, GitHub, Twitch, Bluesky, Mastodon, Discord, Reddit and Telegram. Everything else is typed by hand — the editor says so: this network has no free public API to auto-fetch.

Content widgets

The fourteen widgets in the Content tab hold your words, photos, video and links.

Embed: what you can paste

The Embed link or HTML code box takes either a link or the full embed markup you copy from a platform's own Embed option. A Detected: chip tells you what it recognised: youtube, instagram, tiktok, spotify, vimeo, twitter, or custom.

Video: the editor and the plan caps

Uploading a clip opens a full Edit video sheet with four modes — Trim, Filter, Adjust and Stickers — and a Save button that exports and attaches it. Images, video and files walks through every control.

Interactive widgets

The eight widgets in the Interactive tab do something when a visitor touches them. Read what a visitor can do further down before you rely on any of them — one of them stores far less than it looks like it does, and one stores more than its own help text admits.

Shop widgets

The six widgets in the Shop tab are about money and services. None of them take a payment on your page — they all send the visitor somewhere else. Selling through the marketplace is a different system, covered in Selling and payouts.

Personality widgets

Three widgets sit in the Personality tab. Two are simple; the third has a whole test behind it.

The Personality widget, end to end

This widget shows one of three things: a five-spoke OCEAN radar you earn by taking a test in the app, a self-picked MBTI type card, or a self-picked Enneagram card. It is free on every plan, including its test.

Switching between the three does not delete anything. Your radar, your four-letter code and your number all live side by side, so switching back brings the old one straight back.

Before you take it

An untaken tile shows a brain icon, the word Personality and Take the test, over a faint radar shape.

Taking the OCEAN test

The test is presented as five letter-characters — O, C, E, A and N — who interview you in turn. While its code loads you see Loading test….

1. 1Open the widget's Edit Widget sheet and tap Take the test. The intro reads The five want to meet you. Tap Let's talk. — or Maybe later. to leave, which changes nothing.
2. 2Answer each question by tapping one of five choices: no., not really., in between., kind of., very much. A counter top-right reads 01 / 10.
3. 3The character reacts for a beat, then the next question slides in. Tap anywhere to hurry it along.
4. 4After ten questions you reach a checkpoint: That's a real result. Take Meet the real you. to see your result now, or the second button to answer ten more.
5. 5On the result screen, tap Wear it on your page. to save it into the widget.

The bank holds 30 questions in three rounds of ten, balanced so a result is fair whether you stop at 10, 20 or 30. Your result is labelled quick read at ten, good read at twenty and deep read at thirty. Every trait scores 0 – 100.

• Keyboard — arrow keys move between the five answers, and Enter or Space commits one. Focus starts on in between. Escape closes the whole test.
• Going back — a Back button steps to the previous question. It is blocked while a character is mid-reaction.
• Reduced motion — if your device asks for less animation, the big reveal is skipped and you land straight on the result. The result itself is identical.

The result screen

• A five-spoke radar with the axis letters O, C, E, A and N.
• A card headed Your standout trait with that trait's name and description.
• Five rows, one per trait, each with a percentage bar. Tap a row and its character explains your score — the hint reads Tap a trait — its character will explain you..
• If you went deeper, a dashed grey outline of your previous result, captioned The dashed shape is your last read — see what moved..
• Go deeper — 10 more questions. while you are below thirty, Review to walk back through your answers, and Wear it on your page. to keep it.

Saving it

Saving the result into the widget is not the same as saving your page. From the editor you get Saved to your page! / Your personality radar is now on your grid. — you still have to press Save in the editor. From Preview you get Your personality is on your page!, and the same rule applies.

MBTI and Enneagram

Set Personality system to MBTI and pick one of sixteen codes under Your type. The card shows the type's emoji, its four-letter code, its persona name, a caption and a strip of the four letters along the bottom. Enneagram works the same way with nine numbered types.

Both cards paint themselves in a fixed colour that belongs to the type's family, which is why the Background color picker disappears when either is selected. Write your own one-liner in Caption (optional), or leave it empty to use the type's built-in line. The two systems share that caption field.

Layout widgets

The six widgets in the Layout tab shape a page rather than fill it. They are what turns a long grid into something with sections.

Explore widgets

The twelve widgets behind the compass icon are toys, games and page furniture. Most of them do something when a visitor taps them. Three never react to a tap at all — Sticker, Lava Lamp and Decoration — and only the first two are pure decoration. A Decoration can now also print a clock, a quote, a ticker, an icon or a photo of yours, so it is dressing that sometimes has something to say. It still has nothing to tap.

The Decoration widget, end to end

A risograph is a duplicator that prints one colour of ink at a time, each through its own screen. The sheet comes out with the layers very slightly out of line, the ink half-transparent where two colours cross, and every flat area broken into a screen of dots. The Decoration widget is that machine. You choose a motif to print, the inks to print it in, and how badly the press misbehaves.

It is added at 1×1 and stretches to 4×1. A fresh one is a full-bleed halftone in the Fluoro inks on off-white paper, and it never reacts to a tap.

The 38 motifs, in four groups

• Fields — 12 full-bleed pattern beds, the wallpaper of the set: Halftone, Halftone ramp, Stripes, Chevron, Checker, Target, Sunburst, Waves, Crosshatch, Speckle, Crop marks and Press grid.
• Shapes — 11 single figures printed into the middle of the cell: Arches, Discs, Blob, Star, Daisy, Sun, Bolt, Squiggle, Triangles, Heart and Doodles.
• Furniture — 7 edge treatments, for joining two widgets rather than filling one: Fat rule, Torn edge, Ticker band, Tape, Ribbon, Scallop and Stitch.
• Content — 8 motifs that carry something of yours: Quote, Clock face, Clock digits, Icon disc, Duotone, Ticker, Badge and Big number. Picking one of these opens a Content section with the one field it needs — a line of text, a timezone, an icon or a photo. The other 30 motifs show no such section at all.

The inks

Every motif draws from the same four colours, and they overprint the way real ink does: where two inks cross they multiply into a third. That is why a pink-and-blue halftone has purple in it that you never picked, and it is most of what makes the widget look printed rather than drawn.

• Three inks — the three plates. Not every motif uses all three; a field usually prints in two and keeps the third for its accents.
• Paper — the stock underneath. This is a real background colour, and it can be taken away entirely with the Transparent (sticker) toggle above it: with no paper the widget's background is transparent and the print sits directly on your page, the same trick Sticker does. The Paper picker disappears while that toggle is on, and turning it back off returns the stock you had rather than the factory off-white.
• Five palettes — ready-mixed: one tap sets all three inks and the paper at once, except while Transparent (sticker) is on, where it sets the inks and leaves the sheet off. Fluoro is pink, blue and yellow on off-white. Sunset swaps in orange and teal. Garden is green, violet and coral on a warmer stock. Press is blue and near-black on plain white. Night stock is the dark one: yellow, pink and mint on near-black.

The press

Four sliders control how the machine behaves rather than what it prints.

• Misregistration, 0 – 10 px — how far the plates sit out of line. Zero is a clean digital print; the shipped 3 px is the wobble that makes it read as riso at all.
• Halftone, 4 – 16 px — one cell of the dot screen. Small is a fine newsprint screen, large is a comic-book dot you can count.
• Coverage, 30 – 100 % — how much ink goes down. A riso drum never lays a true solid, so even at the top some paper shows through.
• Grain — paper tooth, read out as a percentage. It ships at off because it is the most expensive thing in the widget to draw. Turn it up on the one decoration you want to look hand-pulled, not on all of them.

Placement

Four more controls move the finished print inside its cell without changing the print itself: Scale from 0.40 to 1.60 ×, Rotation from −45 to 45 °, Opacity from 20 % up to a solid 100 %, and a Die cut toggle that trims the print with a cut edge instead of squaring it off to the cell. Opacity stops at 20 % rather than 0 on purpose: an invisible widget is indistinguishable from a broken one. Die cut starts off, and it is the one worth reaching for after you clear the paper: on a sheet the motif is printed into the page, but floating bare it wants the white outline that makes the eye read it as a sticker stuck on top.

Motion

29 of the 38 motifs move. The other nine are simply prints and hide both motion controls: Crop marks, Press grid, Fat rule, Torn edge, Tape, Scallop, Quote, Duotone and Big number.

• Motion — five styles. Still holds the print still, Drift floats it, March walks the pattern steadily in one direction, Pulse breathes it in and out, and Spin turns it.
• Speed — three, greyed out while Motion is Still. Slow is a nine-second loop, normal is six seconds, fast is 3.6. One motif is often several moving layers, and they all take the same loop length, so a marching stripe and the dot screen over it never drift apart.

Custom widgets from the marketplace

A custom widget is one somebody built in the Widget Builder and published. It is a fixed arrangement of text, images, icons, buttons, shapes, embeds, lists, progress bars, badges and dividers — never code you have to trust.

You get one from the Store tab of the Add a widget popup, which lists the free ones, or by installing it from the marketplace. The marketplace covers buying and owning.

What you can change

Everything, and nothing more. The creator decides which parts of their widget are editable when they publish it, and your Edit Widget sheet builds one control per exposed part, under a chip showing the widget's name.

• A toggle for anything the creator exposed as on-or-off.
• A colour picker for anything exposed as a colour.
• An insert-or-replace image field for images.
• A text box for everything else, with a web-address hint on link fields.

If the creator exposed nothing, the sheet says This widget has no editable options..

What a visitor can actually do

A widget is a picture in some places and a control in others. It is live on your published page and in the editor's Preview. On the editor canvas, in feed cards, in discover tiles and in template galleries, taps select or scroll instead — timers show a single frame and embeds show a placeholder.

Three rules that apply everywhere

• Everything pauses off screen — rotations, clocks, countdowns, auto-advancing galleries, embeds and the music preview all stop when they scroll away, and restart when they come back.
• Reduced motion is honoured — if a visitor's device asks for less animation, galleries stop auto-advancing, the before-and-after nudge is suppressed, confetti becomes a single gentle pulse, the 8-ball skips its shake and countdown digits stop flipping.
• An unfilled link is not tappable — a widget whose address you never filled in renders as plain text rather than a link. It will never open a broken tab.

Widget by widget

The details worth knowing

• Video sound is page-wide — unmuting one clip unmutes every clip, and the choice is remembered across pages and reloads. If you baked the audio out when you exported the clip, there is no sound button and tapping does nothing.
• Video plays sparingly — a clip only plays when it is entirely on screen, at most two at a time on a phone and four on a desktop. Extra clips wait on their poster frame.
• The music embed restarts — a Spotify or YouTube player that scrolls out of range is unloaded, which is the only way to stop a third-party player. Scrolling back starts it from the beginning.
• Copy can fail silently — if a browser blocks clipboard access nothing happens at all, and the button never says Copied. There is no fallback.
• The FAQ opens on its first question — that is deliberate, so the accordion does not read as an empty stack of bars.
• Contact's Save button — appears when there is a real name or an email or a phone number. A card with only a job title has nothing to save, so no button.
• Subscribe collects for the page owner — never for whoever is signed in. Duplicate addresses are accepted quietly, and the response never reveals whether an address was already on the list.
• Small tiles hide their own controls — most widgets drop labels, hints and buttons on a very small tile. A one-cell gallery is a photo with no arrows; a one-cell before-and-after has no grip; a one-cell pet can be tapped but not fed. If a control seems missing, make the widget bigger.

Empty states you can publish by accident

Some widgets tell a visitor they are unfinished. Others quietly substitute an example, which a visitor cannot tell apart from real content. The second group is the one to watch.

Widgets that admit they are empty

Widgets that invent something instead

• Bookshelf → one book, A good book by Someone, 40 % read.
• Film Log → one film, A film, 2026, four stars.
• 3 Things → one fact, A fact about me..
• Obsessed With → one item, something new.
• Timeline → one milestone, 2026 It begins.
• Photo Gallery → one placeholder photo.
• Latest Posts → one post, My first post, with no working link.
• Weekly Schedule → one slot, Monday 19:00, Live stream.
• Stat Counters → one stat, 120+ projects.
• Skills → three tags: Design, Code, Coffee.
• Testimonials → one five-star quote, Amazing work! from A happy client.
• Button group → one button, My link, not clickable.
• Tip Jar → amounts 3, 5 and 10.
• Price List → one row, Service, 100.
• My Setup → one item, My favorite thing.
• Magic 8-Ball → one answer, It is certain..
• Copy code → the code SAVE10.
• FAQ → one row, A question? / The answer goes here..
• Subscribe → the title Join the newsletter.
• Map → the place Somewhere.
• Passport → one stamp, Tokyo '24.
• Coin Flip → YES and NO.

What a template leaves behind

Applying a template keeps its layout and resets its identity, media and ratings, so you are never publishing someone else's claims. That leaves a few tiles deliberately blank rather than plausible: a rating of 0.0, a product with a bare currency symbol, unfilled star outlines on testimonials, unnamed poll bars at 0 %, labelled but empty stat columns, and an FAQ whose rows keep their shape but have no words in them. A personality tile always arrives untaken.

What ships if you never touch a widget

Every widget arrives with content already in it, so it never looks broken while you are building. That content is invented. If you add a tile and publish without opening it, this is what a visitor reads — and several of these read as claims about you.

When something goes wrong

Adding, resizing and deleting

• Phone mode is full or Desktop mode is full / No free cell in phone mode. Move or resize widgets to make room. — a widget has to fit in both canvases. Move or shrink something, or make the widget you are adding land somewhere else.
• No space to resize / No free space to grow this widget — even after rearranging. Move or remove a widget to make room. — the grid tried to push its neighbours aside and could not. Delete or shrink a neighbour first.
• Delete this widget? / You've shared this widget as a post. Deleting it will also delete that post card. This can't be undone. — confirming with Delete both removes the post too. There is no undo for the post.

The Store tab

• Couldn't load the store — tap to retry. — the list failed to fetch. Tap it to try again.
• No shared widgets yet. — there are no free community widgets to show. Nothing is wrong.
• Couldn't add that widget. — the install failed. Try again; if it keeps failing, the listing itself may be broken.

Paid features

• Paid feature / Shape masks need a paid plan. — masks need Élégante or above. The server drops a mask from a free account even if one is somehow set.
• Paid feature / Custom fonts need a paid plan. — every font except Default needs Élégante or above, whatever the dropdown's label says.
• Publishing needs a paid plan. — listing a widget in the marketplace needs Élégante or above.
• Couldn't publish that widget. — the listing was refused for some other reason. Check the title is filled in and try again.

AI

• That's today's rewrites. — you have used the free rewrites your plan allows for now. They come back on their own over the following day, gradually rather than all at once.
• One rewrite at a time — try again in a moment. — rewriting too fast is briefly limited. Wait a moment.
• That came back the same. Try saying it another way. — the model made no change. Be more specific about what you want.
• Couldn't rewrite that. — the request failed outright. Try again.
• Write something first — the Assist panel needs text in the field before it can improve it.

Live data and syncing

• Not available yet / This platform's API key isn't set up on the server. — that platform's connector is not configured. Type the number by hand instead; nothing you can change will fix it.
• Couldn't fetch live data — the platform answered with an error. Check the handle is exactly right.
• TikTok account linking isn't enabled on this server yet. Numbers stay manual for now. — account linking is unavailable. Type the numbers by hand.
• Sync failed — with the reason attached, usually that the feed had no entries. Check the address is a feed, not a home page.
• Fetch failed — the same, for a stat's live source.

Media

• Pick a video file. — the Video widget only takes video. Use Image for photos.
• Couldn't save that video — try again. — the export failed. Try again, or with a shorter clip.
• Add videos from the video widget's editor. — you picked a video inside an image field. Use the Video widget instead.
• Upload failed — with the server's reason where there is one. Common causes are a file type that is not allowed, a file over your plan's per-file cap, or your storage being full.

Music

• No results / Try the song + artist name. — the catalogue found nothing. Add the artist.
• Search failed — the search itself errored. Try again.
• Couldn't fetch title — the title could not be read from the link. Type it in.

What visitors see when something fails

• Couldn't subscribe. Try again. — the signup did not go through. The form stays on screen so the address is not lost.