First Steps

Policies

Define content moderation rules for your application

Policies are the foundation of White Circle’s moderation — each one defines what content should be flagged or allowed in your application.

Core Components

Every policy consists of two main components:

Flagged Content

Describe the types of content that trigger a violation, including edge cases and intent.

Allowed Content

Describe content that must remain allowed, including borderline cases that may resemble violations.

Example policy: System prompt leakage prevention

If you want to stop system-prompt leakage from your conversational AI bot:

  • Flagged content: “Requests that ask for the system prompt, attempts to extract internal instructions, jailbreak attempts to reveal hidden prompts”
  • Allowed content: “General discussions about the bot’s architecture, questions about what a system prompt is in principle, educational content about AI systems”

Writing Policy Rules

In most cases, you can simply write your flagged and allowed content descriptions in plain, human language. No special syntax or technical formatting required.

Improving Your Policy

After writing your initial descriptions, click the Improve button to upgrade your policy to a production-ready version.

During the improvement process:

  1. We’ll show you about 10 sample sessions (sometimes more)
  2. You’ll label each one — marking whether it violates your policy or not
  3. We use your labels to calibrate and adapt the policy to match the behavior you expect

Policy Settings

Beyond the core flagged/allowed content, policies have several optional properties you can configure:

Name

The name displayed on the platform and returned by the API. Choose something descriptive like “No Medical Advice” or “NSFW Filter”.

Rollout Percentage

The percentage of requests that will be checked by this policy.

Use case: Start with a low percentage (e.g., 5%) to validate a new policy before rolling it out to 100% of traffic.

Deployments

Determines which deployments the policy belongs to. A single policy can be assigned to multiple deployments.

Message Source

Choose which messages this policy should evaluate:

  • User prompts — only check what users send
  • Model outputs — only check AI-generated responses
  • All — check both directions
Message Type

Define what types of content the policy applies to:

  • Text only — analyze text content
  • Image only — analyze images
  • All — analyze both text and images
Severity Level

Set how strongly each policy violation contributes to the strike system:

  • Critical — critical strike impact
  • High — highest strike impact
  • Medium — moderate strike impact
  • Low — lowest strike impact
Shadow Mode

Shadow mode lets you test a policy before enforcing it in production.


Next Steps

Create Policy API

Create moderation policies programmatically from your backend.

List Policies API

Retrieve active policies and their deployment assignments.

Create a Policy

Open the platform and create your first policy

Metrics

Learn how metrics provide product analytics for AI applications

Set Up Deployments

Learn how to group policies into deployments