For AI agents: the complete documentation index is available at /pptxgenjs-plus/llms.txt, the full documentation bundle is available at /pptxgenjs-plus/llms-full.txt, and this page is available as Markdown at /pptxgenjs-plus/deprecated.md.

Deprecated

Planned for the next major

Naming and unit inconsistencies that cannot be fixed without breaking existing decks (tracked in issue #29). Non-breaking halves of these have already shipped:

AreaTodayPlanned
Stroke thicknessBorderProps.pt (points) vs ShapeLineProps.width (points)width everywhere; pt is deprecated and still honoured
Layout dimensionsdefineLayout({ name, width, height })w/h accepted today; width/height remain supported
margininches on table cells, points on slide numbersinches everywhere
AlignmentHAlign/VAlign strings vs the exported TEXT_HALIGN/TEXT_VALIGN OOXML enumsone vocabulary - the string unions

Version 3.0 Breaking Changes

Please see the Version 3.0 Migration Guide

  • pptx.colors is deprecated - use pptx.SchemeColor
  • pptx.charts is deprecated - use pptx.ChartType
  • pptx.shapes is deprecated - use pptx.ShapeType

Version 2.0 Breaking Changes

Version 2.0.0 included a cleanup of the API surface and may break existing code. In most cases a search-and-replace of the renamed option names resolves the breakage.

Although the changes primarily affect cosmetic properties, test your solutions thoroughly before upgrading pptxgenjs to the 2.0 version.

All Users

The library getVersion() method is now a property: version

Option names are now camelCase across all methods:

  • font_face renamed to fontFace
  • font_size renamed to fontSize
  • line_dash renamed to lineDash
  • line_head renamed to lineHead
  • line_size renamed to lineSize
  • line_tail renamed to lineTail

Options deprecated in early 1.0 versions:

  • marginPt renamed to margin

Node Users

  • require('pptxgenjs-plus') no longer returns a singleton instance
  • pptx = new PptxGenJS() will create a single, unique instance
  • Advantage: This simplifies creating multiple presentations - see Issue #83 for details.