Presentation

CoreProperties instance for this presentation.

Provides read/write access to the Dublin Core document properties for the presentation.

The lxml element proxied by this object.

Instance of NotesMaster for this presentation.

If the presentation does not have a notes master, one is created from a default template and returned. The same single instance is returned on each call.

Height of slides in this presentation, in English Metric Units (EMU).

Returns None if no slide width is defined. Read/write.

SlideLayouts collection belonging to the first SlideMaster of this presentation.

A presentation can have more than one slide master and each master will have its own set of layouts. This property is a convenience for the common case where the presentation has only a single slide master.

First SlideMaster object belonging to this presentation. Typically, presentations have only a single slide master. This property provides simpler access in that common case.

SlideMasters collection of slide-masters belonging to this presentation.

Width of slides in this presentation, in English Metric Units (EMU). Returns None if no slide width is defined. Read/write.

Slides object containing the slides in this presentation.

Import every slide of source_prs, in order, at the end of this deck.

paper-pptx addition, built on :meth:import_slide — same mode semantics and refusal ledger. The COMPLETE source deck validates before the first write: a refusal on any source slide leaves this presentation untouched. Source sections are not copied (this deck's section structure governs — declared).

Apply the complete footer state to every slide ("Apply to All").

paper-pptx addition. Persists exactly what PowerPoint's Insert > Header & Footer dialog does: materializes minimal dt/ftr/sldNum placeholder shapes per slide (binding to the layout furniture by idx), writes slide numbers and automatic dates as real a:fld elements whose cached text consumers refresh on open, and removes the placeholders for unchecked elements — each call sets the full three-element state, like the dialog.

footer: literal footer text, or None to remove the footer placeholder. slide_number: True writes a slidenum field cached with the current position (honoring firstSlideNum); consumers renumber live after any reorder. date_format: a datetime..datetime13 token for an automatically-updating date field; fixed_date: literal date text (the dialog's "Fixed" mode); passing both raises ValueError. now seeds the date field's cached text (None = wall clock); the package never vouches for cached values — they are consumer-refreshed hints. skip_title_slides: the dialog's "Don't show on title slide" — slides on a type="title" layout get the all-removed state.

Refuses atomically (UnsupportedStructureError, validated deck-wide before the first write) when a wanted element has no layout furniture to inherit from, or when explicit p:hf flags on a layout/master disable it (clear those via header_footers first — this API never flips them silently).

Validate this deck once at block exit instead of once per mutating call.

paper-pptx addition. Opt-in; per-edit validation stays the default.

with prs.batch(): for slide in prs.slides: slide.shapes[0].text_frame.text = "..."

Paper's own mutating APIs each run a package transaction that serializes and reopens the whole deck before committing. Inside this block those transactions nest, and only the outermost validates — one whole-deck check per block rather than one per call. Measured 2.8-3.0x on 25-200 slide decks.

It also validates operations that had no validation at all. The mutation surface inherited from python-pptx — text_frame.text, add_textbox, add_picture, :meth:Slides.add_slide and the rest — runs no transaction of its own. Inside a block the enclosing transaction covers them, so a sequence that previously succeeded and saved an unreadable deck now refuses. That is the intended improvement, not a regression, but it does mean working code can start refusing once wrapped.

Costs and limits, all of which argue for scoping a block to a unit of work you would be willing to redo:

• Entry is not free. Block entry snapshots every reachable part. An empty block costs about what one unbatched edit costs, so a block around a single edit breaks even and the gain starts at two.
• Rollback granularity is the block. A refusal discards every edit in it, not just the offending one.
• Only the end state is checked. A deck that is momentarily invalid inside the block but valid at exit commits normally.
• Saving inside a block is refused (BoundaryViolationError), because the package has not been validated yet and the edits may still roll back. Save after the block closes.
• Blocks on two different decks must exit in reverse order of entry, or RuntimeError.
• Digitally signed decks refuse at block entry, before any edit runs.
• :meth:import_slide and :meth:append_deck return their report before the import has been proven reopenable; that proof moves to block exit.

An exception raised by the caller inside the block rolls the package back and propagates unchanged.

Import slide from source_prs into this presentation; return the report.

paper-pptx addition. mode is required — there is no right default, the caller chooses consciously:

• "adopt_theme": content transplants and rebinds to a destination layout (auto only on a unique exact layout name, then a unique exact non-custom layout type; target_layout overrides; orphan placeholders bake from their source-resolved look). The slide takes the house style; every run whose resolved values changed is in run_shifts.
• "keep_appearance": the source layout+master+theme chain transplants, fingerprint-deduplicated (ten slides from one source share one master).
• "bake": resolvable effective values become explicit local properties, furniture placeholders (dt/ftr/sldNum) drop, remaining placeholders become free shapes, and the slide attaches to a destination layout selected by the same unique name/type tiers, then a unique blank-layout fallback. It never falls back to the first layout. Stable look without importing masters.

The source presentation is never mutated. Media always copies (never shared across packages); charts deep-copy with workbooks; SmartArt carries opaquely; comments drop (reported); OLE objects, controls, internal slide links, and unknown relationship types refuse (RelationshipPolicyError) before any write. notes copies the speaker-notes part re-linked to this deck's notes master. section selects an existing destination section by unique exact name; section_id selects by exact stored GUID when names collide. They are mutually exclusive. With neither selector, enrollment remains adjacent to the insertion point when this deck has sections. Missing selectors raise TargetNotFoundError and duplicate matches raise AmbiguousTargetError before any write. Multiple candidates at any automatic layout tier raise AmbiguousTargetError before any write and list the layouts; pass an enrolled destination target_layout to resolve that choice explicitly. Adopt-theme placeholder reconciliation first preserves exact type+idx matches, then accepts same-type or compatible-family fallbacks only when unique. Pass a partial placeholder_map={source_idx: target_idx | None} to resolve ambiguity; None deliberately orphans and bakes that source placeholder. The argument does not apply to keep-appearance or bake imports. Whole-deck append remains automatic-only.

Writes this presentation to file.

file can be either a file-path or a file-like object open for writing bytes.

A file-path destination is written atomically, resolving symlinks, so a failure part-way through leaves any existing file untouched. A file-like destination is written straight through once the whole package has serialized successfully. See :meth:pptx.opc.package.OpcPackage.save for what atomic replacement costs.

:func:pptx.package.patch_save is the narrow-save alternative: atomic too, and it restores the original bytes of every part that did not change. Its no-op round trip is byte-identical only for a package paper-pptx wrote; see that function for why.

Refuses with BoundaryViolationError while a :meth:batch block is open on this package: those edits have not been validated yet and may still roll back, so writing them out would publish a package the block is not prepared to stand behind. Save once the block has closed.