Skip to content

Reusable Sections

A reusable section is a saved group of slides that SlideSpeak inserts as-is into a generated presentation. Use it for company-approved content you want in many decks — a corporate overview, a security appendix, a standard closing — without regenerating it each time.

Reusable sections are not design kits. A design kit shapes the style of the slides SlideSpeak generates; a reusable section inserts saved slide content unchanged. The two are independent and can be used together.

Create and edit reusable sections in the SlideSpeak web app (they are not created through the API). Each section has a fixed placementbeginning (before all generated slides) or end (after all generated slides) — and a stable id.

When you call Generate a Presentation, pass a section’s id as settings.reusable_section_id:

{
"prompt": "Quarterly business review",
"settings": { "reusable_section_id": "rs_overview", "length": 10 }
}

SlideSpeak inserts the section’s current slides into the generated deck at its placement. Updating the section later does not change presentations already generated.

settings.length is the final deck size, including the inserted reusable slides. SlideSpeak generates the remaining slides so the total matches. For example, with length: 10 and a 3-slide section, SlideSpeak generates 7 slides and inserts the 3 saved slides.

Because length counts the final deck, settings.length must be greater than the section’s slide count. Inserted slides count toward credit usage, billed on the final slide count.

List the sections available to your API key with the List Reusable Sections endpoint, or copy a section’s ID from the reusable sections page in the SlideSpeak web app. Each section includes:

  • an id — pass this as settings.reusable_section_id
  • a name — the section’s display name
  • a placement — where the section is inserted, beginning or end
  • a slide_count — how many slides the section adds to the final deck
  • an updated_at timestamp — when the section was last changed