Card

Card

Decorative container — Rectangle, Rounded, or Circle/Pill. Holds an optional image with 9-point alignment. Not a nesting container.

Wraps customtkinter.CTkFrame (renders as a CTkFrame on export).

Properties

Group	Properties
Geometry	x, y, width, height
Shape	type (Rectangle / Rounded / Circle/Pill), corner_radius
Border	toggle, border_width, border_color
Fill	fg_color (default #3f5c8a)
Image	source (file or Lucide), 9-point alignment, padding from edges

Shape rules

Type	Corner radius
Rectangle	locked at 0
Rounded	freely editable
Circle/Pill	auto-locks to min(W, H) / 2 (square = circle, non-square = pill)

Container behavior

Card is not a nesting container — other widgets cannot be dropped inside. Layout manager rows are hidden in the Properties panel.

Exact set comes from the descriptor in app/widgets/card.py.

---

See also — Widgets · CTkFrame · Image