Skip to content

Cards & layouts

This page shows every WakaTime card layout and the image parameters that all cards accept. Every example below is a static SVG committed to the repository, so the page needs no API or backend at render time.

![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&layout=compact)

Set the layout with layout=…. Without the parameter the card uses normal.

Layoutlayout valueWhat it shows
NormalnormalTitle, one row per language with a progress bar and the duration.
CompactcompactTwo columns of languages with a stacked segmented progress bar.
Text onlynormalThe normal layout with hide_progress=true: names and durations, no bars.
PosterposterA language column plus a segmented bar, with room for an embedded image on the right.
TerminalterminalA waka@username window with a $ wakatime stats prompt and a block bar per row.
TimesheettimesheetDotted leaders to a right-aligned duration column and a bold total row.
RibbonribbonOne thick ribbon of language-colored segments plus a two-column legend.
EditorialeditorialOversized language names, right-aligned durations and thin rules.
WakaTime card in the normal layout
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan)
WakaTime card in the compact layout
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&layout=compact)
WakaTime card with progress bars hidden
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&hide_progress=true)

The poster layout keeps a right-hand column free for an embedded image. Leave image_url out and the language column uses the full card width.

WakaTime card in the poster layout
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&layout=poster)

The terminal layout uses square corners, so border_radius is ignored. hide_progress=true removes the block bars and percentages.

WakaTime card in the terminal layout
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&layout=terminal)

The total row only counts the languages visible after hide and langs_count. display_format=percent switches the duration column to percentages.

WakaTime card in the timesheet layout
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&layout=timesheet)

Segments of at least 12% show their percentage inside the ribbon; narrower segments are labelled in the legend below.

WakaTime card in the ribbon layout
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&layout=ribbon)

The editorial layout draws no title unless you pass custom_title. Combine it with hide_border=true for a borderless look.

WakaTime card in the editorial layout
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&layout=editorial)

All five cards accept the same image parameters. The server fetches image_url and embeds it into the SVG as a data URI, so GitHub’s Camo proxy can render it and no external request happens from the visitor’s browser.

NameDescriptionTypeDefault
image_urlPublic HTTPS URL of the image to embed.stringnull
image_posWhere to draw it: left, right, top or background.enumright
image_sizeSize as a percentage of the card height, clamped to 20–60.number40
image_shapeClipping shape: rect, rounded or circle.enumrounded
image_opacityOpacity between 0 and 1.number1
![WakaTime stats](https://github-stats-extended.vercel.app/api/wakatime?username=alan&image_url=https%3A%2F%2Fexample.com%2Favatar.png&image_pos=left&image_size=50&image_shape=circle&image_opacity=0.9)

See the WakaTime card page for the remaining options.