Add from: Widgets → Add widget → Projects
Add the widget
Open the Widgets editor
Go to Widgets and tap Add widget → Projects.
Add a project
Tap + Add project. Fill in a banner, title, description, project link, and pick tech badges (all covered below).
Per-project fields
Each project card has:| Field | What it does |
|---|---|
| Banner image | The image at the top of the card. Upload a file (JPEG / PNG / WebP / GIF, max 2 MB) or paste an http(s) image URL. Tap Replace banner to swap it. |
| Title | The project name. Required to save. Up to 120 characters. |
| Description (optional) | A short blurb — what it is, what you built. Up to 600 characters. |
| Project link | Where the Visit button sends people. Must be a valid http(s):// URL. Opens in a new tab. |
| Button text | The label on the Visit button. Up to 40 characters. Leave it blank and it falls back to “Visit”. |
| Tech badges | The languages and platforms behind the project — up to 16 per card. See below. |
Tech badges
Each project can list tech badges — the programming languages and platforms behind it. Tap + Add tech badges to open the searchable picker, grouped into Languages and Platforms.- Languages (20): TypeScript, JavaScript, Python, Lua, Rust, Go, C, C++, C#, Java, Kotlin, Swift, Ruby, PHP, Dart, HTML, CSS, SQL, Shell, Elixir.
- Platforms (6): Windows, macOS, iOS, Android, Linux, Web.
Display options
Two widget-level controls sit above the project list:| Control | Options |
|---|---|
| Tech badge style | Icon + text (default) shows the logo and the name. Icon only shows just the logo. |
| Projects per row | Auto (responsive) (default), or a fixed 1 / 2 / 3 / 4 per row. |
Limits
- 24 projects per Projects widget.
- 16 tech badges per project.
- Title up to 120 characters; description up to 600; button text up to 40.
- Banner upload max 2 MB (JPEG / PNG / WebP / GIF).
- 16 widgets total per profile.
Tips
- A 16:9 banner fills the card cleanly — that’s the shape the card crops to.
- Lead with your strongest project; cards render in the order you set with the ↑ / ↓ arrows.
- Pick badges that match what you actually shipped — the badges link straight to each technology’s site, so visitors can follow the stack.
Common questions
Is the Projects widget Premium?
Is the Projects widget Premium?
Can I use an image hosted somewhere else for the banner?
Can I use an image hosted somewhere else for the banner?
What happens if I leave the button text blank?
What happens if I leave the button text blank?
My language isn't in the badge list
My language isn't in the badge list
The catalog covers 20 languages and 6 platforms (listed above). Request another in the Discord — badges are added to the catalog over time.
Can I have more than 24 projects?
Can I have more than 24 projects?
Not in one widget. Add a second Projects widget if you need more — you’re capped at 16 widgets total per profile.
Related
Widgets overview
Every widget type and how they render.
Portfolio
Image grid + video clips for visual work.