Skip to main content

Profile Widgets Guide

Create a stunning, personalized profile page with Spritz's Bento-style widget system. Choose from 40+ widget types to showcase your personality, interests, and Spritz features.

Overview​

Profile widgets allow you to:

  • Customize your page: Drag-and-drop widget arrangement
  • Showcase interests: Music, books, games, movies
  • Display Web3 identity: NFTs, wallet addresses, ENS
  • Enable interactions: Guestbooks, polls, reaction walls
  • Integrate Spritz features: Scheduling, messaging, AI agents

Widget Categories​

Spritz Features​

Core Spritz integrations for your profile.

WidgetDescriptionSizes
Message MeQuick link to chat with you1x1, 2x1, 2x2
WalletDisplay your wallet address1x1, 2x1, 2x2
Let's MeetBook a call scheduling link1x1, 2x1, 2x2
AI AgentShowcase your AI agent1x1, 2x1, 2x2
Social LinkLink to social profiles1x1, 2x1

Location & Time​

Show where you are and when you're available.

WidgetDescriptionSizes
MapInteractive location map1x1, 2x1, 2x2, 4x1, 4x2
WeatherCurrent weather display1x1, 2x1
ClockWorld clock display1x1, 2x1
Time ZoneShow overlap with visitors1x1, 2x1, 2x2

Media & Social​

Share your content and social presence.

WidgetDescriptionSizes
ImageCustom uploaded imageAll sizes
VideoYouTube, Vimeo, Loom embed2x1, 2x2, 4x2
SpotifyMusic you love2x1, 2x2, 4x1
GitHubContribution graph2x1, 2x2, 4x1, 4x2
Social PostEmbed tweets/posts2x2, 4x2

Web3​

Showcase your on-chain identity.

WidgetDescriptionSizes
NFTDisplay owned NFTs1x1, 2x1, 1x2, 2x2
Tip JarAccept crypto tips1x1, 2x1, 2x2

Interactive​

Engage visitors with interactive elements.

WidgetDescriptionSizes
PollLet visitors vote2x1, 2x2
GuestbookVisitor messages2x2, 4x2
Reaction WallEmoji reactions1x1, 2x1, 2x2
Virtual PetAnimated companion1x1, 2x1, 2x2
Fortune CookieRandom wisdom1x1, 2x1, 2x2

Aesthetic​

Beautiful visual widgets.

WidgetDescriptionSizes
Photo CarouselRotating slideshow2x1, 2x2, 4x2
Mood BoardImage collage2x2, 4x2
Color PaletteBrand/favorite colors2x1, 4x1
Vinyl RecordSpinning album art1x1, 2x2
Polaroid StackStacked photos2x2, 4x2
Zodiac SignAstrological sign1x1, 2x1

Entertainment​

What you're into.

WidgetDescriptionSizes
BookshelfBooks you're reading2x1, 2x2, 4x1, 4x2
Now PlayingCurrent game2x1, 2x2
Watch ListMovies/shows queue2x1, 2x2, 4x2
PodcastsPodcasts you love2x1, 2x2, 4x1

Productivity​

Show your work habits.

WidgetDescriptionSizes
AvailabilityStatus indicator1x1, 2x1
StreakDaily streaks1x1, 2x1
GoalsPublic checklist2x1, 2x2

Fun & Personal​

Express yourself.

WidgetDescriptionSizes
TextQuote or custom text1x1, 2x1, 2x2, 4x1
LinkCustom link preview1x1, 2x1, 2x2
CountdownEvent countdown1x1, 2x1, 2x2
StatsCustom metrics2x1, 2x2, 4x1
Tech StackTechnologies you use2x1, 2x2, 4x1
CurrentlyWhat you're doing1x1, 2x1, 2x2
Fun CounterCount anything1x1, 2x1
Visitor CounterRetro hit counter1x1, 2x1
Random FactFun facts about you2x1, 2x2
LanguagesLanguages you speak1x1, 2x1, 2x2

Widget Sizes​

Widgets use a grid system with these size options:

SizeDimensionsBest For
1x1SquareIcons, counters, avatars
2x1WideLinks, stats, music
1x2TallImages, NFTs
2x2Large squareMaps, videos, complex widgets
4x1BannerGitHub graph, color palette
4x2Large bannerMood boards, photo galleries

Using the Widget Editor​

Adding Widgets​

  1. Go to your profile page
  2. Click Edit Profile
  3. Click Add Widget
  4. Select a widget type
  5. Configure the widget
  6. Drag to position
  7. Save changes

Drag and Drop​

Widgets can be rearranged by dragging:

  • Drag widgets to reorder
  • Widgets auto-snap to grid
  • Other widgets shift to accommodate

Widget Configuration​

Each widget has specific configuration options:

Map Widget Example:

{
  "latitude": 40.7128,
  "longitude": -74.0060,
  "city": "New York",
  "country": "USA",
  "zoom": 12,
  "style": "dark",
  "label": "Based in"
}

Spotify Widget Example:

{
  "type": "track",
  "spotifyUri": "spotify:track:4iV5W9uYEdYUVa79Axb7Rh",
  "theme": "dark"
}

Profile Themes​

Customize your profile's appearance with themes:

Built-in Themes​

ThemeStyle
DarkClean dark background with orange accents
MidnightDeep blue gradient with indigo accents
SunsetPurple gradient with pink/orange accents
OceanBlue gradient with cyan accents
ForestGreen gradient with emerald accents
LightClean light background

Custom Theme Options​

interface ProfileTheme {
    background_type: 'solid' | 'gradient' | 'image' | 'mesh';
    background_value: string;
    accent_color: string;
    secondary_color?: string;
    text_color: string;
    card_style: 'rounded' | 'sharp' | 'pill';
    card_background: string;
    card_border?: string;
    font_family: 'system' | 'inter' | 'mono' | 'serif';
    show_spritz_badge: boolean;
    background_effect?: 'none' | 'sparkles' | 'stars' | 'particles' | 'bubbles' | 'snow';
}

Background Effects​

Add animated effects to your profile:

EffectDescription
NoneNo animation
SparklesTwinkling sparkle particles
StarsStarfield effect
ParticlesFloating particles
BubblesRising bubble effect
SnowFalling snowflakes

API Reference​

Get Profile Widgets​

GET /api/profile/widgets?address=0x...

Update Profile Widgets​

POST /api/profile/widgets

Request Body:

{
  "widgets": [
    {
      "id": "uuid",
      "widget_type": "map",
      "size": "2x2",
      "position": 0,
      "is_visible": true,
      "config": {
        "latitude": 40.7128,
        "longitude": -74.0060,
        "city": "New York"
      }
    }
  ],
  "theme": {
    "background_type": "gradient",
    "background_value": "linear-gradient(135deg, #0f0f23 0%, #1a1a2e 100%)",
    "accent_color": "#6366f1"
  }
}

Best Practices​

  1. Start simple: Begin with 4-6 widgets, add more over time
  2. Balance sizes: Mix large and small widgets for visual interest
  3. Group related widgets: Put social links together, media together
  4. Use Spritz features: Message Me and Schedule widgets drive engagement
  5. Keep it updated: Regularly refresh your "Currently" and "Now Playing" widgets