Format PowerPoint Presentation

Changes the master theme settings of the provided PowerPoint presentation and returns the resulting file.

Parameters

Name	Type	Required	Description
Document	File content	Yes	PowerPoint file content (e.g. output of a “Get file content” action from SharePoint).
Colour Scheme Colour(s)	Object	No	Mapping of colour scheme keys to hex values. Only supplied keys will be updated.

Colour Scheme Options

Scheme Key	HEX Colour Value
Colour Scheme body/ColourScheme/Dark1	#________
Colour Scheme body/ColourScheme/Dark2	#________
Colour Scheme body/ColourScheme/Accent1	#________
Colour Scheme body/ColourScheme/Accent2	#________
Colour Scheme body/ColourScheme/Accent3	#________
Colour Scheme body/ColourScheme/Accent4	#________
Colour Scheme body/ColourScheme/Accent5	#________
Colour Scheme body/ColourScheme/Accent6	#________
Colour Scheme body/ColourScheme/Light1	#________
Colour Scheme body/ColourScheme/Light2	#________
Colour Scheme body/ColourScheme/Hyperlink	#________
Colour Scheme body/ColourScheme/FollowedHyperlink	#________

Returns

Name	Type	Description
File content	String (base64‑encoded)	Base64‑encoded bytes of the updated PowerPoint file, with the master theme colours applied. Ready for use by other actions, such as file creation actions.

Troubleshooting

Click to expand common errors and fixes

Document Missing, Truncated or Invalid

Cause:
Document input is empty, truncated, or not a valid PowerPoint file.

Fix:

• Provide the complete presentation binary/base64.
• Verify the file opens locally to confirm it is not corrupted.

---

Colour Keys Not Recognised / Ignored

Cause:
Supplied colour scheme keys do not exactly match the expected key names (case or path differences).

Fix:

• Use the canonical scheme key strings exactly.
• Supply only keys you intend to change; unspecified keys remain unchanged.

---

Invalid Hex Colour Values

Cause:
Hex values are malformed (missing #, wrong length, invalid characters), or not in #RRGGBB format.

Fix:

• Provide colours in valid hex form, e.g. #1A2B3C.
• Avoid shorthand or non-hex formats. Validate hex strings before submission.

---

Changes Do Not Appear on Slides (Manual Formatting Overrides)

Cause:
Shapes, text or slides were manually formatted (direct formatting) and therefore inherit local overrides rather than master theme colours.

Fix:

• Inspect affected slides for manual overrides.
• Reset slide element formatting to “Use theme” or reapply the slide layout so master colours propagate.
• Document that direct formatting is not overridden by master-colour updates.

---

Some Master Elements Unchanged (Multiple Masters / Custom Layouts)

Cause:
Presentation contains multiple masters or custom slide layouts; the provided keys updated one master but not others.

Fix:

• Identify which master(s) require updates and supply changes for each as needed.
• If a specific master is targeted, confirm your process updates all relevant masters or iterate per-master.

---

File Protected / Read-Only Prevents Update

Cause:
Presentation is write-protected or contains restrictions that prevent modification.

Fix:

• Supply an unprotected copy.
• Remove read-only or protection settings before applying theme changes.

---

Output Appears Corrupted or Fails to Open

Cause:
Returned payload is truncated, incorrectly encoded, or the update process failed mid-write.

Fix:

• Verify the returned base64 string decodes successfully and the file opens.
• Re-run with a small test presentation to confirm whether truncation or encoding issues persist.

---

Colour Format Differences in Different Viewers

Cause:
Rendering or colour management differences across viewers produce visual variance.

Fix:

• Test the updated presentation in the target viewer(s).
• Colour profile and display differences are viewer-dependent; consider embedding colour profiles if fidelity is critical.

---

Generic Runtime or Transient Error

Cause:
Malformed inputs, transient processing failure, or unexpected internal error.

Fix:

• Reproduce the issue with a minimal sample presentation and a minimal colour map.
• Validate inputs and retry to rule out transient failures.

Quick Checklist

• Document is a full PowerPoint binary/base64 (not a path or URL).
• Colour scheme keys match the canonical key strings exactly (case-sensitive).
• Hex colour values are valid #RRGGBB strings.
• Presentation is not write-protected or encrypted.
• Be aware manual formatting overrides and multiple masters/layouts can prevent visible changes - reset formatting or update all masters as needed.
• Test changes on a small sample presentation before applying broadly.
• If the output is corrupted, reproduce with a minimal file and the exact colour mapping used - those inputs are required to isolate the cause.