A minified IAM policy pulled from a CLI response, a CloudTrail event, or a squashed Terraform state file is technically readable but painful to review — one long line (or a handful of them) with no indentation to show which brace belongs to which statement. IAM Policy Beautifier takes that JSON, parses it, and re-prints it with consistent, readable indentation so nested statements, conditions, and principal blocks are visually structured the way you would hand-format them yourself.
Formatting only requires the pasted text to be valid JSON — it does not require the document to already be a well-formed IAM policy. That distinction matters because you often want to beautify a document specifically to review whether it is well-formed. So if the JSON parses but the shape looks off (no Statement array, a statement with no Effect, and similar), the tool still formats the JSON as-is and shows a separate structural warning alongside it, rather than refusing to format until the policy is perfect.
If the pasted text is not valid JSON in the first place — a trailing comma, a missing brace, an unescaped quote inside a string — beautifying stops there and you get a specific line and column pointing at the syntax problem, the same detection technique used by the IAM Policy JSON Syntax Validator in this category.
Choose 2-space or 4-space indentation; either is purely cosmetic and has no effect on how the policy evaluates once attached to a role, user, or resource.