The Settings page controls how Moderation behaves for your whole account: your quota usage, how results are saved as metadata, and how rejections work. This article explains every setting.
Quota Usage
At the top of Settings, you'll see how many Moderation Actions you've used out of your plan's limit - for example, "250 of 10,000 Moderation Actions" - with a progress bar.
As you approach your limit you'll see a status label: Getting low, Almost out, and finally Quota reached. When you need more, use the Contact Us button to reach Cloudinary support.
See "Understand Moderation Actions" for how usage is counted.
Structured Metadata
Automatically write moderation result to Structured Metadata
When this toggle is on, moderation results are saved to each asset automatically after moderation - and the manual "Save Metadata" button on run pages is disabled, since there's nothing left to do by hand.
When it's off (the default), nothing is written to your assets until you select Save Metadata to Assets on a run.
Affects: runs started after you change it. Runs already in progress keep the setting they started with.
Applies to: your whole account, for everyone who uses Moderation.
Use custom Structured Metadata fields
By default, Moderation saves results to its own fields in your Cloudinary account. Turn this on to map results to your own structured metadata fields instead — useful when your organization already has naming conventions or existing fields that workflows depend on.
When enabled, a Custom field mapping table appears with three rows:
Field | What it stores | Required field type in Cloudinary |
Moderation result | Approved / Rejected / Needs review | Single-selection list |
Rejection reason | The reasons an asset was rejected | Multi-selection list |
Moderation note | The reviewer's note from a manual decision | Text |
For each row, pick the External ID of one of your existing metadata fields (the dropdown only offers fields of the right type) and set the Display name you want shown across the Moderation app. Changes save automatically as you fill them in.
Things to know:
Each field can be mapped only once - you'll see an error if two rows use the same External ID.
If a mapped field is later deleted in Cloudinary, the row is flagged: "This field no longer exists. Please clear and re-select."
Turning the toggle off clears all your mappings and returns to Cloudinary's default fields. The app asks you to confirm: Turn off and clear or Keep mappings. This cannot be undone.
Rejection reason dialog
"Ask for rejection reasons when rejecting assets" - when on (the default), rejecting an asset opens a short dialog where you can select reasons and add a note. Turn it off to reject immediately without being asked; this also overrides the "Don't show this again" checkbox in the dialog itself.