Use Icons and Shapes in OPF

Use an icon to identify a short list entry, metric or group. Use a shape block when the outline itself carries the message, such as an arrow or a callout. Keep a text label with the drawing so its meaning does not depend on sight alone.

Find and copy an icon

Search Icons across the published Lucide and Tabler sets. Select a tile to copy its exact reference, such as lucide:rocket. Names and tags help you find the drawing; the copied reference identifies its set as well.

An item can name the icon directly:

{ "text": "Launch", "description": "Ship the reviewed update.", "icon": "lucide:rocket" }

A host registers the sets with galleryIconSets() from @openpresentation/gallery/icon-sets, which reads only the icons a deck names: in Node from the installed package, in a browser page as galleryIconSets(fetchIcons("/opf-icons/")) over the package's icon files copied to that folder. To share a complete deck with a host that has no icon catalog, copy the portable OPF config on a set page. It embeds the icons that its sample actually uses. Retain the set's license and attribution; both are shown on its page and included in the embedded record.

Agents can discover the sets through the icons presentation API and read their original package records through /icon-sets/index.json. The index and record files describe the catalog; the presentation API links to the human reference pages.

Choose a preset shape

Browse Shapes by PowerPoint group or common words. For example, a search for “speech bubble” finds the rectangular callout. Its page shows the default frame, adjust values and a complete copyable deck.

A shape block can carry text:

{ "shape": "chevron", "text": "Plan" }

The chevron and right arrow pages show their individual adjust ranges. OPF uses fractions and degrees rather than raw DrawingML units. A range marked unbounded has no finite bound for that handle; it does not mean every outline can take every value.

The shapes presentation API exposes the same engine-derived names, proportions and adjustments. These presets are engine vocabulary, not gallery-authored catalog records. Export writes native PowerPoint preset shapes with their adjust values.

For a connected process or system, see Add a Diagram to a Slide and the Diagrams gallery.