Tile Reference
All 12 tile types available in Boxli.
Text
textMarkdown-enabled text block. Great for bios, descriptions, or any rich content.
Fields
| Field | Type | Description |
|---|---|---|
| heading | string? | Optional heading rendered as h2 |
| body | string | Main content. Supports Markdown (bold, italic, links, lists, code) |
Use cases
Link
linkA clickable card that opens a URL. Auto-fetches page title on paste.
Fields
| Field | Type | Description |
|---|---|---|
| title | string | Card title |
| url | string | Destination URL |
| description | string? | Short subtitle |
| imageUrl | string? | Preview image URL |
Use cases
Button
buttonA prominent CTA button with label and destination URL.
Fields
| Field | Type | Description |
|---|---|---|
| label | string | Button text |
| url | string | Destination URL |
Use cases
Image
imageA full-bleed image tile. Supports upload or external URL.
Fields
| Field | Type | Description |
|---|---|---|
| url | string | Image URL |
| alt | string? | Alt text for accessibility |
| caption | string? | Optional caption below image |
Use cases
Social
socialA social media handle tile with platform icon and accent color.
Fields
| Field | Type | Description |
|---|---|---|
| platformName | string | Platform key (Twitter, GitHub, Instagram, LinkedIn, TikTok, YouTube, Threads, Bluesky, Twitch, Spotify) |
| username | string | Handle including @ |
| url | string | Profile URL |
Use cases
Location
locationShows a city/region with a map pin aesthetic.
Fields
| Field | Type | Description |
|---|---|---|
| city | string | City name |
| country | string? | Country name or code |
| mapUrl | string? | Optional Google Maps link |
Use cases
Rich Card
rich-cardA flexible card with title, body, and an optional icon or emoji header.
Fields
| Field | Type | Description |
|---|---|---|
| title | string | Card heading |
| body | string? | Supporting text |
| icon | string? | Emoji or icon identifier |
| url | string? | Optional click-through URL |
Use cases
Embed
embedEmbeds a URL as an iframe. Auto-detects Spotify, YouTube, SoundCloud, and Calendly.
Fields
| Field | Type | Description |
|---|---|---|
| url | string | URL to embed |
| title | string? | Fallback title |
Use cases
Newsletter
newsletterEmail capture form with a CTA label and success state.
Fields
| Field | Type | Description |
|---|---|---|
| heading | string | Form heading |
| placeholder | string? | Input placeholder text |
| ctaLabel | string? | Submit button label |
| successMessage | string? | Message after submission |
| actionUrl | string? | Form POST target (e.g. Mailchimp endpoint) |
Use cases
Divider
dividerA section divider with an optional heading label.
Fields
| Field | Type | Description |
|---|---|---|
| label | string? | Section heading above the rule |
Use cases
Gallery
galleryA 2–4 image grid within a single tile cell.
Fields
| Field | Type | Description |
|---|---|---|
| images | GalleryImage[] | Array of { url, alt?, caption? } objects (2–4 images) |
Use cases
Video
videoA native HTML5 video player tile.
Fields
| Field | Type | Description |
|---|---|---|
| url | string | Video file URL (.mp4, .webm) |
| poster | string? | Thumbnail image URL |
| autoplay | boolean? | Autoplay on load (muted) |
| loop | boolean? | Loop the video |
Use cases