Docs

User Guide

Complete guide for all features

anonymize.today - User Guide

Last Updated: December 30, 2025
Classification: PUBLIC

Table of Contents

  1. Getting Started
  2. Core Features
  3. Advanced Features
  4. Account Management
  5. Token System
  6. Security Features
  7. Troubleshooting
  8. FAQ

Getting Started

Creating an Account

  1. Visit anonymize.today
  2. Click "Get Started Free" or "Sign Up"
  3. Enter your email address and create a password
    • Password must be at least 12 characters
    • Must include uppercase, lowercase, number, and special character
  4. Verify your email address (check your inbox)
  5. You'll automatically receive 300 tokens on the Free plan

Signing In

  1. Go to anonymize.today
  2. Click "Sign In" in the top right
  3. Enter your email and password
  4. If you have 2FA enabled, enter your verification code

Note: After 5 failed login attempts, your account will be locked for 30 minutes.

Understanding the Interface

After signing in, you'll see:

On Desktop (≥1024px):

  • Sidebar Navigation: Access to all features on the left
  • Token Display: Your current token balance (top right)
  • Main Content Area: Where you work with your data
  • Settings: Access via the user menu (top right)

On Mobile/Tablet (<1024px):

  • Hamburger Menu: Tap the menu icon (☰) in the top left to open navigation drawer
  • Mobile Header: Compact header with page title and sign-out button
  • Token Display: Available in the navigation drawer
  • Touch-Optimized: All buttons and controls are sized for easy tapping (44px minimum)
  • Responsive Layout: Content adapts to your screen size automatically

Core Features

1. PII Analyzer

Purpose: Detect personally identifiable information (PII) in text

How to Use:

  1. Navigate to Analyzer from the sidebar
  2. Paste or type your text in the input area
  3. Select entity types you want to detect:
    • PERSON (names)
    • EMAIL_ADDRESS
    • PHONE_NUMBER
    • LOCATION
    • CREDIT_CARD
    • And many more...
  4. Choose language from 15 supported languages (English, German, Spanish, French, Italian, Portuguese, Dutch, Polish, Russian, Japanese, Chinese, Korean, Arabic, Hindi, Turkish)
  5. Adjust confidence threshold (default: 0.5 or 50%)
  6. Click "Analyze"

Results:

  • Highlighted text: Detected entities are highlighted in different colors
  • Results table: Shows entity type, location, and confidence score
  • Token cost: Displays how many tokens were used

Tips:

  • Use presets to quickly select common entity combinations
  • Lower confidence threshold = more detections (may include false positives)
  • Higher confidence threshold = fewer detections (more accurate)
  • If you change language after applying a preset, you'll see a warning showing the original preset language

Token Cost: Typically 1-10 tokens depending on text length and entities found

2. PII Anonymizer

Purpose: Anonymize detected PII using various operators

How to Use:

Option A: Analyze and Anonymize in One Step

  1. Navigate to Anonymizer from the sidebar
  2. Paste your text
  3. Select entity types
  4. Choose anonymization operators for each entity:
    • Replace: Replace with custom text (e.g., "[REDACTED]")
    • Redact: Remove completely
    • Hash: SHA-256, SHA-512, or MD5 hash
    • Encrypt: AES encryption (requires encryption key) - Basic+ plans
    • Mask: Partially mask characters (e.g., "J*** D**")
  5. Click "Anonymize"

Option B: Use Analyzer Results

  1. First, use Analyzer to detect entities
  2. Click "Use in Anonymizer" button
  3. Configure operators for each entity type
  4. Click "Anonymize"

Operators Explained:

  • Replace: Good for readability, replaces with fixed text
  • Redact: Removes text completely (most privacy)
  • Hash: One-way transformation, can't be reversed
  • Encrypt: Reversible with the same key (for deanonymization) - Basic+ plans
  • Mask: Shows partial information (e.g., "j***@example.com")

Token Cost:

  • Apply-only (with analyzer results): 1-5 tokens
  • Full anonymize (without analyzer results): 2-10 tokens

3. Deanonymize (Basic+ Plans)

Purpose: Reverse encrypted anonymizations to restore original text

How to Use:

  1. Navigate to Deanonymize from the sidebar
  2. Paste your encrypted text (from Anonymizer output)
  3. Select the same encryption key you used for anonymization
  4. Click "Deanonymize"

Important:

  • Only works with encrypted entities (not hashed or redacted)
  • You must use the same encryption key
  • Keys must be 16, 24, or 32 characters long
  • Requires Basic, Pro, or Business plan

Token Cost: Typically 1-4 tokens

4. Batch Processing (Basic+ Plans)

Purpose: Process multiple texts at once

How to Use:

  1. Navigate to Batch from the sidebar
  2. Add multiple texts (one per line or separate entries)
  3. Select entity types and language
  4. Click "Process Batch"

Results:

  • Each text is analyzed separately
  • Results are shown for each text
  • You can export results

Token Cost: Each text is charged separately using the analyze formula

Plan Requirement: Basic, Pro, or Business plan required

Advanced Features

5. Custom Entities

Purpose: Create custom patterns to detect specific types of information

How to Use:

  1. Navigate to Entities from the sidebar
  2. Click "Create Entity" or "Create Entity with AI" (Basic+ plans)

Manual Entity Creation:

  1. Enter entity name and description
  2. Write a regex pattern (e.g., \d{4}-\d{4}-\d{4}-\d{4} for credit cards)
  3. Provide examples (positive and negative)
  4. Select languages and category
  5. Test your pattern
  6. Save

AI-Powered Entity Creation (Basic+ Plans):

  1. Click "Create Entity with AI"
  2. Step 1: Describe what you want to detect and provide examples
  3. Step 2: AI generates 3 pattern options (Balanced, Simple, Complex)
  4. Step 3: Test patterns and refine if needed
  5. Step 4: Review and save

Token Cost: 50 tokens per AI operation (generation, refinement, validation)

Sharing Options:

  • Private: Only you can use it (all plans)
  • Team: Your organization can use it (Basic+ plans)
  • Public: All users can use it (Basic+ plans)

Editing Entities (v4.5.7+):

  1. Click the Edit button (pencil icon) on any entity card
  2. Modify the entity name, description, or patterns
  3. Add new patterns or remove existing ones
  4. Click "Update Entity" to save changes
  5. Your changes are immediately available for use
  6. The "Updated" timestamp will show when the entity was last modified

Deleting Entities (v4.5.7+):

  1. Click the Delete button (trash icon) on any entity card
  2. Confirm the deletion in the dialog (shows entity name for confirmation)
  3. The entity will be removed from your list
  4. Note: Deleted entities are soft-deleted and can be recovered by support if needed

Tips:

  • Test patterns thoroughly before using in production
  • Use specific patterns to avoid false positives
  • Edit entities instead of recreating them to preserve history
  • Each entity can have multiple patterns with different confidence scores
  • Higher confidence scores (closer to 1.0) indicate stronger matches

6. Presets

Purpose: Save common entity and operator combinations for quick reuse

How to Use:

  1. Navigate to Presets from the sidebar
  2. Click "Create Preset"
  3. Configure:
    • Name and description
    • Entity types to detect
    • Operators for each entity type
    • Language and confidence threshold
  4. Save

Using Presets:

  • Select a preset in Analyzer or Anonymizer
  • All settings are automatically applied
  • You can still modify settings after applying
  • Language Warning: If you change the language after applying a preset, you'll see a warning showing the original preset language

Built-in Presets:

  • General PII Detection (Default)
  • GDPR Compliance
  • HIPAA Medical
  • Financial Services
  • Development & Testing
  • Multi-Language European

Sharing Options:

  • Private: Only you can use it (all plans)
  • Team: Your organization can use it (Basic+ plans)
  • Public: All users can use it (Basic+ plans)

Editing Presets (v4.5.7+):

  1. Click the Edit button (pencil icon) on any user-created preset card
  2. Modify the preset name, description, entities, language, or threshold
  3. Entity selection persists correctly during editing
  4. Click "Update Preset" to save changes
  5. Your changes are immediately available for use
  6. The "Updated" timestamp will show when the preset was last modified
  7. Note: Built-in presets cannot be edited (they're protected - no edit/delete buttons shown)

Deleting Presets (v4.5.7+):

  1. Click the Delete button (trash icon) on any user-created preset card
  2. Confirm the deletion in the dialog (shows preset name for confirmation)
  3. The preset will be removed from your list
  4. Note: Built-in presets cannot be deleted (no delete button shown)

Tips:

  • Edit presets instead of recreating them to preserve history
  • Built-in presets are read-only but you can create copies
  • Timestamps show when presets were last updated

7. Encryption Key Management (Basic+ Plans)

Purpose: Manage encryption keys for anonymization and deanonymization

How to Use:

  1. Navigate to Settings → Encryption Keys
  2. Click "Add Key"
  3. Enter:
    • Key name (for easy identification)
    • Key value (16, 24, or 32 characters)
    • Or generate a random key
  4. Set as default for specific entity types (optional)
  5. Save

Key Features:

  • Keys are encrypted at rest
  • Usage history tracking
  • Export keys (encrypted backup)
  • Set default keys per entity type

Security:

  • Keys are never displayed in full (masked)
  • Each key can be used for any entity type
  • Keys are user-specific (not shared)

Account Management

Settings Overview

Access Settings from the sidebar or user menu. Settings are organized into tabs:

  1. Account: Profile information, email change, password change, data export
  2. Billing: Subscriptions, payment methods, invoices
  3. Tokens: Balance, usage statistics, transaction history
  4. Security: Two-factor authentication, session management, backup codes
  5. Services: AI service configuration, Presidio connection test
  6. Developer: API token management (Basic+ plans)

Updating Your Profile

  1. Go to Settings → Account tab
  2. Update your name
  3. Click "Save Changes"

Note: To change your email address, see the "Changing Your Email Address" section under Security Features.

Changing Your Password

  1. Go to Settings → Account tab
  2. Click "Change Password"
  3. Enter current password
  4. Enter new password (must meet requirements: 12+ chars, upper/lower/number/special)
  5. Confirm new password
  6. Click "Update Password"

Managing Subscriptions

  1. Go to Settings → Billing tab
  2. View your current plan and subscription status
  3. Upgrade: Click "Upgrade Plan" and select a plan
  4. Payment Methods: Choose between PayPal or Stripe
  5. Cancel: Click "Cancel Subscription" (access until cycle end)
  6. View payment history and download invoices

Plans:

PlanTokensPriceKey Features
Free300 / 30 daysFreeAnalyzer, Anonymizer, Personal presets/entities
Basic500 / 31 days€3/month+ Batch, Deanonymize, Encryption, API access, Sharing, Token top-ups
Pro2,000 / 31 days€9/month+ Higher limits, AI entity creation, Advanced features
Business10,000 / 31 days€29/month+ Maximum limits, Priority support, Enterprise features

Payment Methods:

We accept secure payments via:

  • PayPal: Pay with your PayPal account or credit/debit card through PayPal
  • Stripe: Direct credit/debit card payments (Visa, Mastercard, Amex, Discover)

All payments are processed securely with industry-standard encryption. We never store your full card details.

Note: All plans are displayed on the public pricing page at /pricing. The pricing page shows all four plans (Free, Basic, Pro, Business) in a responsive 4-column grid layout with detailed feature comparisons.

Payment Process

Upgrading to a Paid Plan:

  1. Navigate to Settings → Billing tab or visit the Pricing Page
  2. Click "Upgrade Plan" or "Start [Plan Name] Plan"
  3. Review plan details and pricing
  4. Select your preferred payment method:
    • Pay with PayPal: Use your PayPal account or pay by card through PayPal
    • Pay by Card: Direct card payment via Stripe
  5. Complete the secure checkout process
  6. Your plan activates immediately
  7. Tokens are added to your account instantly
  8. You'll receive a confirmation email with invoice

Checkout Experience:

  • PayPal Checkout: Inline checkout box with tabbed interface

    • "Pay with PayPal" tab: Log in to your PayPal account
    • "Pay by Card" tab: Enter card details securely through PayPal
    • Official PayPal branding and security badges
    • Real-time order summary with itemized breakdown

  • Stripe Checkout: Secure card payment form

    • Accepts Visa, Mastercard, American Express, Discover
    • 3D Secure authentication for enhanced security
    • Instant payment confirmation

Subscription Management:

  • View Subscription: See current plan, next billing date, and payment method
  • Cancel Anytime: Cancel from Settings → Billing tab
    • Access continues until the end of your current billing period
    • No refunds for partial months
    • Automatic downgrade to Free plan at cycle end
  • Update Payment Method: Manage payment methods via provider portal
    • PayPal: Update via PayPal account settings
    • Stripe: Update via Stripe customer portal link in Settings
  • View Invoices: Download PDF invoices from Settings → Billing tab
  • Payment History: View all past payments and transactions

Billing Cycle:

  • Subscriptions renew automatically every 31 days (30 days for Free plan)
  • You'll receive an email reminder 3 days before renewal
  • Tokens reset at the start of each new cycle
  • Failed payments trigger email notifications with retry instructions

Security & Privacy:

  • All payments processed via PCI-DSS compliant providers (PayPal, Stripe)
  • We never store your full card details
  • Industry-standard encryption (TLS 1.3)
  • Secure webhook verification for all payment events
  • Comprehensive audit logging of all payment activities

Token System

Understanding Tokens

Tokens are used to track and charge for platform usage. Each operation consumes tokens based on:

  • Text length
  • Number of entities detected
  • Operation type (analyze, anonymize, etc.)

Viewing Your Balance

  1. Go to Settings → Tokens tab
  2. View:
    • Current balance
    • Total allocation
    • Tokens used
    • Cycle dates
    • Transaction history

Token Top-ups (Basic Plan Only)

  1. Go to Settings → Billing tab
  2. Click "Purchase Top-up"
  3. Select amount: +200 tokens for €1
  4. Choose payment method (PayPal or Stripe)
  5. Complete secure checkout
  6. Tokens are added immediately to your balance

Important Notes:

  • Top-ups are exclusive to the Basic plan (as of v4.1.0)
  • Pro and Business plans include sufficient tokens and cannot purchase top-ups
  • Top-up tokens expire at the end of your current billing cycle
  • Payment is processed securely via PayPal or Stripe
  • You'll receive an email confirmation after successful purchase

Token Cycle Reset

  • Tokens reset automatically at the start of each cycle
  • You receive your plan's allocation (300/500/2000/10000 tokens)
  • Unused tokens are not carried over
  • Cycle dates are shown in Settings → Tokens

For detailed token information, see TOKEN_USAGE_GUIDE.md

Security Features

Two-Factor Authentication (2FA)

Purpose: Add an extra layer of security to your account

Setup:

  1. Go to Settings → Security tab
  2. Choose a method:
    • Authenticator App (recommended): Scan QR code with Google Authenticator, Microsoft Authenticator, etc.
    • Email Verification: Receive codes via email
  3. Save backup codes securely
  4. Enable 2FA

Using 2FA:

  • When signing in, enter your password
  • Enter the 6-digit code from your authenticator app or email
  • Click "Verify & Sign In"

Managing 2FA:

  • Enable/disable methods in Settings → Security
  • Set default method (if multiple enabled)
  • Regenerate backup codes if needed

For detailed 2FA information, see TWO_FACTOR_AUTH.md

Session Management 🆕

Purpose: Monitor and control where you're signed in

Viewing Active Sessions:

  1. Go to Settings → Security tab
  2. Scroll to "Active Sessions" section
  3. You'll see all devices where you're currently signed in:
    • Device information: Browser and operating system
    • Location: Country and city (from IP address)
    • Last active: When the session was last used
    • Current session: Highlighted with a badge

Managing Sessions:

  • Revoke a specific session: Click the "Revoke" button next to any session
  • Log out everywhere: Click "Revoke All Other Sessions" to sign out from all devices except your current one
  • Automatic revocation: Sessions are automatically revoked when you:
    • Change your password
    • Change your email address
    • Reset your password

Security Tips:

  • ✅ Regularly review your active sessions
  • ✅ Revoke sessions you don't recognize
  • ✅ Log out from public or shared computers
  • ✅ Use "Log out everywhere" if you suspect unauthorized access

Session Limits:

  • Sessions expire after 30 days of inactivity
  • Sessions are automatically revoked after 24 hours of no activity
  • You can have unlimited active sessions

Changing Your Email Address 🆕

Purpose: Update your account email address securely

How to Change:

  1. Go to Settings → Account tab
  2. Scroll to "Change Email Address" section
  3. Enter your new email address (twice to confirm)
  4. Click "Request Email Change"
  5. You'll be asked to re-authenticate:
    • Enter your password, OR
    • Enter your 2FA code (if enabled)
  6. Check your NEW email for a verification link
  7. Click the verification link within 24 hours
  8. Your email will be updated, and you'll be logged out everywhere

Security Measures:

  • ✅ Re-authentication required: Must verify your identity before requesting
  • ✅ Dual notification: Both old and new emails are notified
  • ✅ 24-hour cancellation window: Old email can cancel the change
  • ✅ Force re-login: All sessions are logged out after the change
  • ✅ Rate limited: Only 1 change request per 24 hours

Canceling a Pending Change:

If you have a pending email change request:

  • Option 1: Click "Cancel Request" in Settings
  • Option 2: Click the cancel link sent to your old email

What Happens After:

  • Your email is updated immediately
  • All active sessions are logged out (for security)
  • You'll need to sign in again with your new email
  • Confirmation emails are sent to both addresses

Password Security 🆕

Password Requirements:

When creating or changing your password, it must:

  • Be at least 12 characters long
  • Include at least one uppercase letter (A-Z)
  • Include at least one lowercase letter (a-z)
  • Include at least one number (0-9)
  • Include at least one special character (!@#$%^&*...)

Password History:

  • You cannot reuse your last 3 passwords
  • This prevents cycling through the same passwords
  • Encourages using unique, strong passwords

Password Reset:

  • Reset links expire after 1 hour for security
  • Each link can only be used once
  • All sessions are logged out after a reset
  • You'll receive a confirmation email

Forgot Your Password? 🆕

If you can't remember your password:

  1. Click "Forgot Password?" on the sign-in page
  2. Enter your email address
  3. Check your inbox (and spam folder) for a password reset link
  4. Click the link within 1 hour (it expires for security)
  5. Create a new password that meets the requirements:
    • At least 12 characters
    • One uppercase letter
    • One lowercase letter
    • One number
    • One special character
  6. Your new password cannot be one of your last 3 passwords
  7. All your active sessions will be logged out for security

Security Note: For your protection, we'll always show the same success message whether your email exists or not. This prevents attackers from discovering which emails are registered.

Account Lockout Protection

Your account is protected against brute force attacks:

  • After 5 failed login attempts, your account is locked for 30 minutes
  • The lockout resets automatically after the timeout
  • Successful login resets the failed attempt counter

API Access Tokens (Basic+ Plans)

Purpose: Access the API programmatically

Setup:

  1. Go to Settings → Developer tab
  2. View or generate your API token
  3. Copy the token (starts with eyJ...)
  4. Use in API requests: Authorization: Bearer YOUR_TOKEN

Security:

  • Tokens never expire (but can be regenerated)
  • Keep tokens secret (like passwords)
  • Regenerate if compromised

For API documentation, see API_REFERENCE.md

Troubleshooting

"Insufficient Tokens" Error

Problem: You don't have enough tokens for an operation

Solutions:

  1. Wait for cycle reset (if close to cycle end)
  2. Purchase top-up (Basic+ plans)
  3. Upgrade to a higher plan
  4. Reduce text length or entity selection

"Service Unavailable" Error

Problem: Backend services are temporarily unavailable

Solutions:

  1. Wait a few moments and try again
  2. Check service status
  3. Contact support if issue persists

"Account Locked" Error

Problem: Too many failed login attempts

Solutions:

  1. Wait 30 minutes for automatic unlock
  2. Use "Forgot Password" to reset your password
  3. Contact support if you believe this is an error

"Invalid Verification Code" (2FA)

Problem: 2FA code not working

Solutions:

  • Authenticator App: Check device time is correct, wait for new code
  • Email: Check spam folder, request new code
  • Backup Code: Use a backup code if available

Pattern Not Detecting Entities

Problem: Custom entity pattern not working

Solutions:

  1. Test pattern with examples
  2. Check regex syntax
  3. Verify language selection
  4. Try AI-powered pattern generation (Basic+ plans)
  5. Check confidence threshold

Encryption/Decryption Not Working

Problem: Can't encrypt or decrypt text

Solutions:

  1. Verify key length (16, 24, or 32 characters)
  2. Use the same key for encrypt and decrypt
  3. Check that you're using the "encrypt" operator (not hash)
  4. Verify key is selected correctly

"Feature Not Available" Error

Problem: Trying to access a feature not included in your plan

Solutions:

  1. Check which features are included in your plan
  2. Upgrade to a plan that includes the feature
  3. Features by plan:
    • Free: Analyzer, Anonymizer, Personal presets/entities
    • Basic+: Batch, Deanonymize, Encryption, API, Sharing, AI entities

FAQ

Q: What is PII?

A: Personally Identifiable Information (PII) is any data that can identify a specific person, such as names, email addresses, phone numbers, credit card numbers, etc.

Q: Is my data stored?

A: No. Your text is processed in real-time and not stored on our servers. Only metadata (usage statistics, token transactions) is stored.

Q: Can I use this for GDPR compliance?

A: Yes! anonymize.today helps you identify and anonymize PII to comply with GDPR and other privacy regulations.

Q: What's the difference between hash and encrypt?

A:

  • Hash: One-way transformation, cannot be reversed (use for permanent anonymization)
  • Encrypt: Reversible with the same key (use when you need to restore original data later)

Q: Can I use my own AI API key?

A: Yes! Go to Settings → Services → AI Service. Click on "Personal API Key Configuration" to expand the section, then enter your OpenAI, Anthropic, Google, or Abacus API key. When using your personal key, no tokens are deducted from your anonymize.today balance - you pay your AI provider directly.

To switch back to the system AI service: Click the "Remove Key" button next to your API key field, then click "Save". This will revert to using the system AI service (50 tokens per request).

Q: How do I share presets or entities with my team?

A: When creating or editing a preset/entity, set the sharing level to "Team". Team members with the same organization will see it. Note: Sharing requires Basic plan or higher.

Q: What happens if I cancel my subscription?

A: You'll be downgraded to the Free plan. Any remaining tokens from your paid plan are lost. You'll receive 300 tokens on the Free plan at the next cycle.

Q: Can I process files?

A: Currently, anonymize.today processes text input. For files, copy and paste the text content into the analyzer or anonymizer.

Q: Is there a mobile app?

A: anonymize.today is a responsive web application that works seamlessly on mobile browsers (iOS Safari, Chrome, Firefox, etc.). You can access all features from your mobile device without installing a separate app.

Mobile Features (v4.5.3+):

  • Hamburger Menu Navigation: Tap the menu icon (☰) to access all features
  • Touch-Optimized Interface: All buttons and controls are sized for easy tapping (44px minimum)
  • Responsive Design: Content automatically adapts to your screen size
  • Full Feature Access: All desktop features available on mobile
  • Token Display: View your token balance in the navigation drawer
  • Optimized Forms: All inputs are full-width and mobile-friendly

Q: How accurate is the detection?

A: Detection accuracy depends on:

  • Text quality and context
  • Selected entity types
  • Confidence threshold setting
  • Language selection

Generally, accuracy is very high (90%+) for common PII types.

Q: Which languages are supported?

A: We support 15 languages with intelligent lazy loading:

Languages with full NLP support (12):

  • English (en), German (de), Spanish (es), French (fr)
  • Italian (it), Portuguese (pt), Dutch (nl), Polish (pl)
  • Russian (ru), Japanese (ja), Chinese (zh), Korean (ko)

Transformer-only languages (3):

  • Arabic (ar), Hindi (hi), Turkish (tr)
  • These use English NLP processing with XLM-RoBERTa for entity recognition

Performance Note: Language models are loaded on-demand. The first request for a new language may take a few seconds longer while the model loads. Subsequent requests are fast.

Q: Why is my analysis slow?

A: Analysis should complete in under 1 second for most texts. If you experience slow analysis:

  1. Check your internet connection
  2. Try a shorter text first
  3. Contact support if the issue persists

Note: As of v4.0.1, analysis performance was significantly improved by optimizing model loading.

Additional Resources

Last Updated: January 1, 2025

PII Analyzer Guide

Last Updated: January 1, 2025
Classification: PUBLIC

Overview

The PII Analyzer is the core feature of anonymize.today, allowing you to detect Personally Identifiable Information (PII) in text with high accuracy. This guide provides detailed information about using the analyzer effectively.

Getting Started

Accessing the Analyzer

  1. Sign in to anonymize.today
  2. Click "Analyzer" in the sidebar (desktop) or hamburger menu (mobile)
  3. You'll see the analyzer interface with:
    • Text input area
    • Entity type selection
    • Language selector
    • Confidence threshold slider
    • Analyze button

Entity Types

The analyzer can detect 50+ entity types across multiple categories:

Personal Information

  • PERSON: Names (first, last, full names)
  • EMAIL_ADDRESS: Email addresses
  • PHONE_NUMBER: Phone numbers (various formats)
  • DATE_TIME: Dates and times
  • AGE: Age information
  • GENDER: Gender indicators

Financial Information

  • CREDIT_CARD: Credit card numbers (all formats: hyphenated, spaced, no separators)
  • IBAN: International Bank Account Numbers
  • SWIFT_CODE: SWIFT/BIC codes
  • US_SSN: US Social Security Numbers
  • US_PASSPORT: US Passport numbers
  • TAX_ID: Tax identification numbers

Location Information

  • LOCATION: Addresses, cities, countries
  • IP_ADDRESS: IP addresses
  • COORDINATE: GPS coordinates

Medical Information

  • MEDICAL_LICENSE: Medical license numbers
  • NPI: National Provider Identifier (US)
  • MEDICAL_RECORD_NUMBER: Medical record numbers

Organizational Information

  • ORGANIZATION: Company names, organizations
  • NRP: National Registry of Persons (various countries)

And Many More...

Note: You can also create custom entities to detect specific patterns not covered by built-in types.

Language Support

anonymize.today supports 15 languages with intelligent lazy loading:

Full NLP Support (12 languages)

  • English (en)
  • German (de)
  • Spanish (es)
  • French (fr)
  • Italian (it)
  • Portuguese (pt)
  • Dutch (nl)
  • Polish (pl)
  • Russian (ru)
  • Japanese (ja)
  • Chinese (zh)
  • Korean (ko)

Transformer-Only Languages (3 languages)

  • Arabic (ar)
  • Hindi (hi)
  • Turkish (tr)

Performance Note: Language models are loaded on-demand. The first request for a new language may take a few seconds longer while the model loads. Subsequent requests are fast.

Confidence Threshold

The confidence threshold determines how certain the analyzer must be before reporting a detection.

Understanding Confidence Scores

  • 0.0 - 0.5: Low confidence (may include false positives)
  • 0.5 - 0.7: Medium confidence (balanced)
  • 0.7 - 0.9: High confidence (fewer false positives)
  • 0.9 - 1.0: Very high confidence (very accurate)

Default Threshold

  • Default: 0.5 (50%)
  • Recommended: 0.5-0.7 for most use cases
  • High Accuracy: 0.7+ for production use

Adjusting the Threshold

  • Lower Threshold (0.3-0.5): More detections, may include false positives

    • Use when: You want to catch everything, even uncertain matches
    • Trade-off: More manual review needed

  • Medium Threshold (0.5-0.7): Balanced approach

    • Use when: General purpose detection
    • Trade-off: Good balance of accuracy and coverage

  • Higher Threshold (0.7-0.9): Fewer but more accurate detections

    • Use when: You need high accuracy, false positives are costly
    • Trade-off: May miss some valid detections

Using Presets

Presets are pre-configured entity combinations for common use cases.

Built-in Presets

  1. General PII Detection (Default)

    • Entities: PERSON, EMAIL_ADDRESS, PHONE_NUMBER, LOCATION, CREDIT_CARD
    • Language: English
    • Threshold: 0.5

  2. GDPR Compliance

    • Entities: All GDPR-relevant entities
    • Language: Multi-language
    • Threshold: 0.6

  3. HIPAA Medical

    • Entities: Medical-related entities
    • Language: English
    • Threshold: 0.7

  4. Financial Services

    • Entities: Financial entities (credit cards, IBAN, SSN)
    • Language: English
    • Threshold: 0.6

  5. Development & Testing

    • Entities: Common test data patterns
    • Language: English
    • Threshold: 0.5

  6. Multi-Language European

    • Entities: European PII types
    • Language: Multi-language (European languages)
    • Threshold: 0.5

Using a Preset

  1. Click the "Preset" dropdown in the analyzer
  2. Select a preset
  3. All settings (entities, language, threshold) are automatically applied
  4. You can still modify settings after applying a preset

Language Warning: If you change the language after applying a preset, you'll see a warning showing the original preset language.

Custom Entities

You can use your own custom entities alongside built-in types:

  1. Create Custom Entities: Go to Entities page and create custom patterns
  2. Select in Analyzer: Custom entities appear in the entity selection list
  3. Visual Distinction: Custom entities show a "Custom" badge
  4. Same Functionality: Custom entities work identically to built-in types

Note: Custom entities are available to all users (your own + public entities).

Results Interpretation

Results Display

After analysis, you'll see:

  1. Highlighted Text: Detected entities highlighted in different colors
  2. Results Table: Detailed list showing:
    • Entity type
    • Start position (character index)
    • End position (character index)
    • Confidence score
    • Detected text

Understanding Results

  • Entity Type: The type of PII detected (e.g., PERSON, EMAIL_ADDRESS)
  • Position: Where in the text the entity was found (start and end indices)
  • Confidence: How certain the detection is (0.0-1.0)
  • Text: The actual detected text

Example Results

For text: "John Doe's email is [email protected]"

Entity TypeStartEndConfidenceText
PERSON080.95John Doe
EMAIL_ADDRESS25420.98[email protected]

Token Costs

Cost Calculation

Token costs are calculated based on:

  • Text length (in thousands of characters)
  • Number of entity types selected
  • Number of entities actually found

Formula (simplified):

Cost = (2 + text_length_k + 0.2 × entities_enabled + 0.1 × entities_found) × 0.5

All costs are reduced by 50% from base formulas.

Typical Costs

  • Short text (100-500 chars): 1-3 tokens
  • Medium text (500-2000 chars): 3-6 tokens
  • Long text (2000+ chars): 6-10 tokens

Cost Estimation

The analyzer shows estimated token cost before you run the analysis. The estimate is based on:

  • Text length
  • Selected entities
  • Expected hit rate (typically 30% of enabled entities)

Note: Actual cost may vary slightly based on entities actually found.

Best Practices

1. Start with Presets

  • Use built-in presets for common use cases
  • Presets are optimized for their specific scenarios
  • You can always modify settings after applying

2. Select Relevant Entities

  • Only select entity types you actually need
  • More entities = higher token cost
  • Unnecessary entities may increase false positives

3. Adjust Confidence Threshold

  • Start with default (0.5) and adjust based on results
  • Lower for maximum coverage
  • Higher for maximum accuracy

4. Test with Sample Text

  • Test with a small sample before processing large texts
  • Verify entity selection and threshold are appropriate
  • Check token costs before large operations

5. Use Custom Entities

  • Create custom entities for domain-specific patterns
  • Share custom entities with your team (Basic+ plans)
  • Use AI assistance for complex patterns (Basic+ plans)

6. Language Selection

  • Select the correct language for your text
  • Language affects detection accuracy
  • Some entities are language-specific

7. Review Results

  • Always review detected entities
  • Check confidence scores
  • Verify detections are correct before anonymizing

Common Use Cases

GDPR Compliance

  1. Select "GDPR Compliance" preset
  2. Analyze your text
  3. Review detected PII
  4. Proceed to anonymization

Financial Data

  1. Select "Financial Services" preset
  2. Analyze financial documents
  3. Focus on credit cards, IBANs, SSNs
  4. Use higher confidence threshold (0.7+)

Medical Records

  1. Select "HIPAA Medical" preset
  2. Analyze medical text
  3. Focus on patient identifiers
  4. Use high confidence threshold (0.7+)

Development & Testing

  1. Select "Development & Testing" preset
  2. Analyze test data
  3. Identify PII in test datasets
  4. Use for data anonymization before testing

Troubleshooting

No Entities Detected

Possible Causes:

  • Confidence threshold too high
  • Wrong language selected
  • Entity types not selected
  • Text doesn't contain the selected entity types

Solutions:

  • Lower confidence threshold
  • Verify language selection
  • Check entity selection
  • Try different entity types

Too Many False Positives

Possible Causes:

  • Confidence threshold too low
  • Too many entity types selected
  • Text contains ambiguous patterns

Solutions:

  • Increase confidence threshold
  • Select only relevant entity types
  • Review and refine entity selection

Slow Analysis

Possible Causes:

  • First request for a new language (model loading)
  • Very long text
  • Network issues

Solutions:

  • Wait for language model to load (first time only)
  • Process text in smaller chunks
  • Check internet connection

Credit Card Not Detected

Note: As of v4.5.2, credit card detection has been improved to detect all formats:

  • Hyphenated: 4532-1234-5678-9010
  • Spaced: 4532 1234 5678 9010
  • No separators: 4532123456789010

If credit cards still aren't detected:

  • Verify CREDIT_CARD entity is selected
  • Check confidence threshold (try lowering to 0.4)
  • Ensure text contains valid credit card patterns

Additional Resources

Last Updated: January 1, 2025

PII Anonymizer Guide

Last Updated: January 1, 2025
Classification: PUBLIC

Overview

The PII Anonymizer allows you to anonymize detected PII using various strategies. This guide provides detailed information about anonymization operators, configuration, and best practices.

Getting Started

Accessing the Anonymizer

  1. Sign in to anonymize.today
  2. Click "Anonymizer" in the sidebar (desktop) or hamburger menu (mobile)
  3. You'll see the anonymizer interface

Two Ways to Anonymize

Option A: Analyze and Anonymize in One Step

  1. Paste your text in the anonymizer
  2. Select entity types to detect
  3. Configure anonymization operators for each entity
  4. Click "Anonymize"
  5. Both analysis and anonymization happen in one operation

Token Cost: Full anonymize cost (analyze + apply, typically 2-10 tokens)

Option B: Use Analyzer Results (Recommended)

  1. First, use the Analyzer to detect entities
  2. Click "Use in Anonymizer" button
  3. Configure operators for each detected entity type
  4. Click "Anonymize"
  5. Only anonymization is performed (analysis already done)

Token Cost: Apply-only cost (typically 1-5 tokens, more efficient)

Anonymization Operators

1. Replace

Replace detected PII with custom text.

Configuration:

  • Replacement Text: Custom text to use (e.g., "[REDACTED]", "[NAME]", "[EMAIL]")

Example:

  • Original: "John Doe's email is [email protected]"
  • Replaced: "[NAME]'s email is [EMAIL]"

Use Cases:

  • Maintaining readability
  • Consistent placeholder text
  • Clear indication of redacted content

Token Cost: Standard apply cost

2. Redact

Remove detected PII completely.

Configuration:

  • No additional configuration needed

Example:

Use Cases:

  • Maximum privacy
  • Complete removal of sensitive data
  • When readability is not important

Token Cost: Standard apply cost

3. Hash

One-way transformation using cryptographic hashing.

Hash Types:

  • SHA-256 (recommended): 256-bit hash, most secure
  • SHA-512: 512-bit hash, highest security
  • MD5: Legacy hash, less secure (not recommended for new use cases)

Configuration:

  • Select hash type (SHA-256, SHA-512, or MD5)

Example:

  • Original: "[email protected]"
  • Hashed (SHA-256): "a1b2c3d4e5f6..." (64 character hex string)

Use Cases:

  • Permanent anonymization
  • Data anonymization for analytics
  • Compliance with data retention policies
  • Creating consistent identifiers (same input = same hash)

Important: Hashes cannot be reversed. Use when you don't need to restore original data.

Token Cost: Standard apply cost

4. Encrypt (Basic+ Plans)

Reversible encryption for later restoration.

Configuration:

  • Encryption Key: 16, 24, or 32 characters
  • Key Selection: Choose from your saved keys or create new
  • Default Keys: Set default keys per entity type

Example:

Use Cases:

  • Temporary anonymization with restoration capability
  • Anonymize for testing, then restore for production
  • Secure data sharing with authorized parties
  • When you need reversible anonymization

Important:

  • You must use the same key for encryption and decryption
  • Keys must be 16, 24, or 32 characters long
  • Keys are encrypted at rest and never displayed in full

Token Cost: Slightly higher due to encryption overhead

Available on: Basic, Pro, Business plans

5. Mask

Partial masking to preserve some information while protecting privacy.

Configuration:

  • Masking Character: Character to use for masking (default: "*")
  • Characters to Mask: Number of characters to mask from the start

Example:

  • Original: "John Doe"
  • Masked (4 chars): "J*** D**"
  • Original: "[email protected]"
  • Masked (4 chars): "j***@example.com"

Use Cases:

  • Maintaining partial readability
  • Showing format without revealing content
  • Balancing privacy and utility

Token Cost: Standard apply cost

Encryption Key Management (Basic+ Plans)

Creating Encryption Keys

  1. Go to Settings → Encryption Keys (or configure during anonymization)
  2. Click "Add Key"
  3. Enter:
    • Key Name: Descriptive name (e.g., "Production Key", "Test Key")
    • Key Value: 16, 24, or 32 characters
    • Or click "Generate Random Key"
  4. Set as default for specific entity types (optional)
  5. Save

Managing Keys

  • View Keys: See all your saved keys (masked display)
  • Set Defaults: Set default keys per entity type
  • Export Keys: Export keys as encrypted backup
  • Usage History: See which keys have been used

Key Security

  • Keys are encrypted at rest (AES-256-GCM)
  • Keys are never displayed in full (masked in UI)
  • Each key can be used for any entity type
  • Keys are user-specific (not shared)

Deanonymization (Basic+ Plans)

Reverse encrypted anonymizations to restore original text.

How to Deanonymize

  1. Navigate to Deanonymize from the sidebar
  2. Paste your encrypted text (from Anonymizer output)
  3. Select the same encryption key you used for anonymization
  4. Click "Deanonymize"

Requirements

  • Encrypted Entities Only: Only works with encrypted entities (not hashed or redacted)
  • Same Key: Must use the same encryption key
  • Key Length: Keys must be 16, 24, or 32 characters
  • Plan Requirement: Basic, Pro, or Business plan

Example

Encrypted Text:

Contact <ENCRYPTED>a1b2c3...</ENCRYPTED> at <ENCRYPTED>x9y8z7...</ENCRYPTED>

After Deanonymization:

Contact John Doe at [email protected]

Token Cost: Typically 1-4 tokens

Batch Processing (Basic+ Plans)

Process multiple texts efficiently in a single operation.

How to Use Batch Processing

  1. Navigate to Batch from the sidebar
  2. Add multiple texts (one per line or separate entries)
  3. Select entity types and language
  4. Configure anonymization operators
  5. Click "Process Batch"

Batch Limits

  • Free Plan: Not available
  • Basic Plan: Up to 100 items per batch
  • Pro Plan: Up to 500 items per batch
  • Business Plan: Up to 5,000 items per batch

Token Costs

Each text in the batch is charged separately using the analyze formula:

  • Total cost = sum of all individual text costs
  • More efficient than processing texts individually

Token Costs

Cost Calculation

Full Anonymize (without analyzer results):

Cost = Analyze Cost + Apply Cost

Apply-Only (with analyzer results):

Cost = Apply Cost only

Apply Cost Formula:

Cost = (1 + 0.2 × ops_count + 0.8 × encrypt_count + 0.1 × entities_found + 0.2 × text_k) × 0.5

All costs are reduced by 50% from base formulas.

Typical Costs

  • Apply-only (with analyzer results): 1-5 tokens
  • Full anonymize (without analyzer results): 2-10 tokens
  • Encryption operations: Slightly higher due to encryption overhead

Best Practices

1. Analyze First, Then Anonymize

  • Use the Analyzer first to see what will be detected
  • Review detected entities and confidence scores
  • Then use "Use in Anonymizer" for efficient processing
  • Saves tokens (apply-only cost vs full anonymize cost)

2. Choose the Right Operator

  • Replace: For readability and consistent placeholders
  • Redact: For maximum privacy
  • Hash: For permanent anonymization
  • Encrypt: When you need to restore data later
  • Mask: For partial information preservation

3. Use Presets

  • Create presets for common anonymization workflows
  • Save time by reusing operator configurations
  • Share presets with your team (Basic+ plans)

4. Manage Encryption Keys

  • Use descriptive key names
  • Set default keys per entity type
  • Export keys as encrypted backup
  • Never share keys publicly

5. Test Before Production

  • Test anonymization on sample text first
  • Verify operators work as expected
  • Check token costs before large operations
  • Review anonymized output

6. Consider Your Use Case

  • GDPR Compliance: Use hash or redact for permanent anonymization
  • Testing: Use encrypt for reversible anonymization
  • Analytics: Use hash for consistent identifiers
  • Sharing: Use replace or mask for readability

Common Workflows

Workflow 1: GDPR Compliance

  1. Analyze text with "GDPR Compliance" preset
  2. Configure operators:
    • PERSON: Redact
    • EMAIL_ADDRESS: Hash (SHA-256)
    • PHONE_NUMBER: Redact
    • LOCATION: Mask
  3. Anonymize
  4. Result: GDPR-compliant anonymized text

Workflow 2: Testing Data

  1. Analyze text
  2. Configure operators:
    • All entities: Encrypt (with test key)
  3. Anonymize
  4. Use anonymized data for testing
  5. Deanonymize when needed for production

Workflow 3: Data Sharing

  1. Analyze text
  2. Configure operators:
    • PERSON: Replace with "[NAME]"
    • EMAIL_ADDRESS: Replace with "[EMAIL]"
    • PHONE_NUMBER: Redact
  3. Anonymize
  4. Share anonymized text with partners

Troubleshooting

Encryption Not Working

Possible Causes:

  • Key length incorrect (must be 16, 24, or 32 characters)
  • Wrong key selected
  • Using hash instead of encrypt

Solutions:

  • Verify key length
  • Select correct key
  • Ensure "encrypt" operator is selected (not "hash")

Deanonymization Failing

Possible Causes:

  • Using wrong encryption key
  • Text was hashed, not encrypted
  • Text was redacted, not encrypted

Solutions:

  • Use the same key used for encryption
  • Verify text contains encrypted entities (not hashed)
  • Encrypted entities are wrapped in <ENCRYPTED>...</ENCRYPTED> tags

Operators Not Applying

Possible Causes:

  • No entities detected
  • Wrong entity types selected
  • Confidence threshold too high

Solutions:

  • Verify entities were detected in analyzer
  • Check entity type selection
  • Lower confidence threshold if needed

Additional Resources

Last Updated: January 1, 2025

AI-Powered Entity Creation Guide

Last Updated: December 30, 2025
Classification: PUBLIC

Table of Contents

  1. Overview
  2. Getting Started
  3. AI Configuration
  4. AI Entity Creator Wizard
  5. Pattern Generation
  6. Pattern Visualizer
  7. Costs and Billing
  8. Best Practices
  9. Troubleshooting

Overview

The AI-powered entity creation feature allows you to create custom entity detection patterns without writing complex regular expressions. The system uses advanced AI models to analyze your examples and generate optimized regex patterns automatically.

Key Features

  • No Regex Knowledge Required: Just provide examples of what you want to detect
  • Multi-Provider Support: Works with OpenAI, Anthropic, Google, and Abacus AI
  • Multi-Language Support: Works with English, German, Spanish, French, Italian, and Portuguese
  • Cultural Awareness: AI considers regional variations and cultural context
  • Chain-of-Thought Reasoning: Advanced prompting for better pattern quality
  • Quality Metrics: See precision, recall, and overall quality scores for each pattern
  • Interactive Pattern Visualizer: Understand and test your patterns visually
  • Test & Refine: Validate patterns against your examples and get AI suggestions for improvements
  • Customizable Preferences: Adjust complexity, precision/recall bias, and use-case context

Getting Started

Prerequisites

  • An active account on anonymize.today
  • Sufficient tokens in your wallet (see Costs and Billing)
  • Examples of the entity you want to detect (at least 2-3 examples recommended)

Accessing the AI Entity Creator

  1. Navigate to Entities in the main menu
  2. Click the "Create Entity with AI" button (or the AI wizard icon)
  3. The 4-step wizard will open

AI Configuration

Understanding AI Key Sources

The AI Entity Creation feature can use two different API key sources:

1. System AI Service (Default)

When you don't configure your own API key, the system uses a shared AI service:

  • Indicator: Blue banner showing "✅ System AI Service Active"
  • Status Message: "Included with your plan • 50 tokens per AI request"
  • Cost: 50 tokens per AI operation (deducted from your wallet)
  • Advantages: No setup required, simple billing
  • Limitations: Provider and model settings are locked
  • How to Switch: Click "Remove Key" button in Personal API Key Configuration section

2. Personal API Key

When you configure your own API key in Settings:

  • Indicator: Green banner showing "🔑 Personal API Key Active"
  • Status Message: "Billed to your [Provider] account • No tokens deducted"
  • Cost: 0 tokens from anonymize.today (you pay your AI provider directly)
  • Advantages: Full control over provider, model, and settings
  • Requirements: Valid API key from supported provider
  • How to Switch: Remove your API key using the "Remove Key" button, then save

Configuring Your AI Preferences

Go to Settings → Services → AI Service to customize your AI configuration.

Current Status Banner

At the top of the AI Service section, you'll see a status banner indicating:

  • 🔑 Personal API Key Active: You're using your own API key
  • ✅ System AI Service Active: You're using the system's shared AI service
  • ⚠️ AI Service Not Configured: No AI service is available

The banner also shows the token cost inline:

  • System AI: "50 tokens per AI request"
  • Personal Key: "No tokens deducted"

Personal API Key Configuration (Collapsible Section)

Click on "Personal API Key Configuration" to expand/collapse the configuration section. When expanded, you can configure:

Provider Settings (Locked when using System AI):

  • Provider: OpenAI, Anthropic, Google, or Abacus
  • Model: e.g., gpt-4o-mini, gpt-4o, claude-3-sonnet
  • Base URL: Custom API endpoint (for enterprise setups)
  • API Key: Your personal API key (masked for security)

Switching Between System and Personal Keys:

  • To use Personal Key: Enter your API key in the configuration section and click "Save"
  • To switch back to System AI: Click the "Remove Key" button next to the API key field, then click "Save"

User Preferences (Always Editable)

These settings customize how the AI generates patterns:

SettingDescriptionOptions
Default ComplexityPattern complexity levelBasic, Intermediate, Advanced
Precision/Recall BiasTrade-off slider0 = High Precision, 1 = High Recall
Default Use CaseIndustry contextGeneral, Healthcare, Finance, Legal, HR
Cultural ContextEnable regional adaptationsOn/Off
Max TokensMaximum response length100-8192
TemperatureAI creativity level0-2 (lower = more deterministic)

Custom Prompts (Advanced)

For power users, you can customize the AI prompts:

  • Pattern Generation Prompt: Customize how patterns are generated
  • Refinement Prompt: Customize how patterns are refined

Note: Custom prompts are validated for security. Prompt injection attempts will be blocked.

AI Entity Creator Wizard

The wizard guides you through 4 steps to create a custom entity:

Step 1: Entity Basics

What to Provide:

  • Entity Name: A descriptive name (e.g., "German Tax ID", "Spanish DNI")
  • Description: What this entity represents and where it's used
  • Examples: At least 2-3 examples of the entity you want to detect
    • Positive Examples: Text that SHOULD be detected
    • Negative Examples (optional): Text that should NOT be detected
  • Languages: Select the languages where this entity appears
  • Category: Choose the appropriate category (Personal, Financial, Medical, etc.)

Tips:

  • Provide diverse examples showing different formats
  • Include edge cases if possible
  • More examples = better pattern quality

Example:

Entity Name: German Tax ID
Description: German Tax Identification Number (Steuerliche Identifikationsnummer)
Examples:
  - 12345678901
  - 98765432109
  - Tax ID: 12345678901
Languages: German, English
Category: Financial

Step 2: AI Pattern Generation

What Happens:

  • AI analyzes your examples using Chain-of-Thought reasoning
  • Generates 3 pattern variations based on your preferences:
    1. Balanced (Recommended): Optimal balance between precision and recall
    2. Simple: High precision, fewer false positives
    3. Complex: High recall, catches more variations

What You See:

  • Pattern quality score (0-100)
  • Precision percentage (how accurate)
  • Recall percentage (how comprehensive)
  • Detailed explanation of how the pattern works
  • Cultural notes (if applicable)
  • Matched and missed examples

Cost Display:

  • System AI: "Using system AI service costs 50 tokens"
  • Personal Key: "Using your personal API key (no token charge)"

What to Do:

  • Review all three options
  • Check the quality metrics
  • Read the explanations
  • Select the pattern that best fits your needs

Step 3: Test & Refine

What to Do:

  • Test the selected pattern against your examples
  • Add more test cases if needed
  • Review test results:
    • ✅ Green checkmark = Pattern matched correctly
    • ❌ Red X = Pattern missed or incorrectly matched

AI Refinement:

  • If tests fail, click "Refine with AI"
  • AI will analyze failures and suggest improvements
  • You can refine multiple times until satisfied

Cost: 50 tokens per refinement request (when using system AI)

Step 4: Review & Save

Final Configuration:

  • Visibility: Choose who can see this entity
    • Private: Only you
    • Team: Your organization
    • Public: All users (contributes to community)
  • Add to Preset (optional): Automatically add to an existing preset

Review:

  • Pattern preview
  • Quality metrics
  • Test results summary

Save:

  • Click "Complete & Save" to create your entity
  • Entity is immediately available for use

Pattern Generation

How AI Generates Patterns

The AI uses advanced Chain-of-Thought (CoT) prompting to:

  1. Analyze Structure: Identifies common prefixes, separators, number patterns
  2. Consider Context: Uses your selected use case (Healthcare, Finance, etc.)
  3. Apply Complexity: Follows your complexity preference (Basic/Intermediate/Advanced)
  4. Balance Trade-offs: Respects your precision/recall bias setting
  5. Cultural Adaptation: Adjusts for language-specific characteristics
  6. Prevent False Positives: Specifically trained to avoid common matching errors

Pattern Quality Metrics

  • Quality Score (0-100): Overall pattern effectiveness
  • Precision (%): Percentage of matches that are correct (fewer false positives)
  • Recall (%): Percentage of valid entities detected (fewer false negatives)
  • F1 Score: Harmonic mean of precision and recall

Understanding the Trade-offs:

  • High Precision: Fewer false matches, but might miss some valid cases
  • High Recall: Catches more valid cases, but might have some false matches
  • Balanced: Best overall performance for most use cases

Pattern Visualizer

The Pattern Visualizer is an interactive tool that helps you understand generated patterns:

Features

  1. Component Breakdown: Each part of the regex is explained

    • Hover over components to see tooltips
    • Color-coded by component type

  2. Real-time Testing:

    • Enter sample text
    • See matches highlighted instantly
    • View match groups and positions

  3. Metrics Display:

    • Precision gauge
    • Recall gauge
    • F1 score

  4. Test Case Results:

    • "Should Match" examples with pass/fail status
    • "Should Not Match" examples with pass/fail status

Using the Visualizer

  1. After pattern generation, click "View Pattern Details"
  2. The visualizer shows:
    • The full regex pattern
    • Flags (case-insensitive, global, etc.)
    • Interactive component breakdown
  3. Enter test text in the input field
  4. Matches are highlighted in real-time

Costs and Billing

Token Costs

AI Entity Creation Operations:

OperationSystem AI CostPersonal Key Cost
Pattern Generation50 tokens0 tokens
Pattern Refinement50 tokens0 tokens
Pattern Validation50 tokens0 tokens

Note: When using your personal API key, you pay your AI provider directly instead of using anonymize.today tokens.

Using System Default API Key

When: You don't configure your own API key

How it Works:

  • System uses the default AI service configured by administrators
  • All AI operations are charged to your anonymize.today token balance
  • No charges to your personal AI provider account

Rate Limits:

  • 10 AI generation requests per minute
  • 30 pattern test requests per minute
  • 15 refinement requests per minute

Advantages:

  • No need to manage API keys
  • Simple setup
  • Unified billing through anonymize.today

Disadvantages:

  • Provider and model settings are locked
  • Shared rate limits with other users

Using Your Own API Key

When: You configure your own API key in Settings → Services → AI Configuration

Supported Providers:

  • OpenAI: GPT-4o, GPT-4o-mini, GPT-4-turbo
  • Anthropic: Claude 3 Opus, Claude 3 Sonnet, Claude 3 Haiku
  • Google: Gemini Pro, Gemini Ultra
  • Abacus AI: Various models

How to Set Up:

  1. Go to Settings → Services tab
  2. Find AI Service section
  3. Click on "Personal API Key Configuration" to expand the section
  4. Enter your API key in the "Your API Key" field
  5. Select provider from the dropdown (e.g., OpenAI, Anthropic)
  6. Select model from the dropdown (e.g., gpt-4o-mini, gpt-4o)
  7. Adjust AI Generation Preferences (optional)
  8. Click "Test" to verify the connection
  9. Click "Save" to apply your configuration

Note: The configuration section is collapsible - click anywhere on the "Personal API Key Configuration" header to expand or collapse it.

How it Works:

  • Your API key is used for all your AI operations
  • AI provider charges are billed directly to your account
  • No anonymize.today tokens are deducted
  • Full control over provider, model, and settings

Advantages:

  • Full control over model selection
  • Use your own AI credits
  • No rate limits from shared usage
  • Customize all settings

Disadvantages:

  • Requires AI provider account setup
  • Additional billing from AI provider
  • Need to manage API key security

Cost Comparison Example

Scenario: Creating 10 custom entities with 2 refinements each

With System Default Key:

  • Token cost: 10 × 50 + 20 × 50 = 1,500 tokens
  • AI provider cost: $0 (covered by system)
  • Total: 1,500 anonymize.today tokens

With Your Own Key (GPT-4o-mini):

  • Token cost: 0 tokens
  • AI provider cost: 30 operations × 1,000 tokens × $0.15/1M = **$0.0045**
  • Total: $0.0045 to your AI provider

Best Practices

Providing Good Examples

✅ Do:

  • Provide 3-5 diverse examples
  • Include different formats if they exist
  • Show real-world usage context
  • Include edge cases
  • Add negative examples for clarity

❌ Don't:

  • Use only similar examples
  • Forget to include context
  • Use made-up or unrealistic examples

Example - Good:

Examples:
- Tax ID: 12345678901
- Steuer-ID: 98765432109
- My tax number is 55512345678
Negative Examples:
- Phone: 12345678901 (not a tax ID)

Example - Bad:

Examples:
- 12345678901
- 12345678902
- 12345678903

Choosing the Right Settings

ScenarioComplexityPrecision/RecallUse Case
General document scanningIntermediate0.5 (Balanced)General
Medical recordsAdvanced0.7 (Higher Recall)Healthcare
Financial auditingBasic0.3 (Higher Precision)Finance
Legal document reviewIntermediate0.4 (Slightly Higher Precision)Legal
HR data processingIntermediate0.5 (Balanced)HR

Testing Thoroughly

  • Test with all your original examples
  • Add edge cases you might encounter
  • Test with negative examples (things that shouldn't match)
  • Use the Pattern Visualizer to understand matches
  • Refine if precision or recall is below 90%

Language Selection

  • Select all languages where the entity appears
  • AI will optimize for cultural and linguistic variations
  • Some entities are language-specific (e.g., German Tax ID)

Troubleshooting

Pattern Quality is Low

Problem: Quality score below 80%

Solutions:

  1. Add more diverse examples
  2. Provide better descriptions
  3. Adjust complexity level in preferences
  4. Change precision/recall bias
  5. Try refining the pattern with AI

Pattern Misses Valid Cases

Problem: Low recall (many false negatives)

Solutions:

  1. Select the "Complex" pattern option
  2. Move precision/recall slider toward recall (right)
  3. Add more examples showing missed variations
  4. Use "Refine with AI" to improve recall
  5. Check if examples are representative

Pattern Has Too Many False Positives

Problem: Low precision (many false matches)

Solutions:

  1. Select the "Simple" pattern option
  2. Move precision/recall slider toward precision (left)
  3. Add negative examples (things that shouldn't match)
  4. Use "Refine with AI" to improve precision
  5. Make description more specific

AI Service Unavailable

Problem: Error message "AI Service Unavailable"

Solutions:

  1. Check your API key in Settings → Services
  2. Verify you have sufficient tokens
  3. Check if rate limit exceeded (wait a minute)
  4. Test connection in Settings
  5. Contact support if issue persists

Rate Limit Exceeded

Problem: Error message "Too Many Requests"

Solutions:

  1. Wait 60 seconds before retrying
  2. Reduce frequency of requests
  3. Consider using your own API key (no shared rate limits)

Custom Prompt Rejected

Problem: Error when saving custom prompt

Solutions:

  1. Remove any prompt injection patterns
  2. Ensure prompt is under 10,000 characters
  3. Use only allowed template variables
  4. Avoid system manipulation attempts

Advanced Features

Cultural Context

When creating entities for specific regions:

  • Enable "Cultural Context" in your preferences
  • Specify the country in the description
  • AI will consider regional variations
  • Cultural notes will appear in pattern explanations

Multi-Language Entities

For entities that appear in multiple languages:

  • Select all relevant languages
  • Provide examples in each language
  • AI will generate patterns that work across languages

Custom Prompts

For advanced users who want to customize AI behavior:

Allowed Template Variables:

  • {{entityType}} - Entity type name
  • {{description}} - Entity description
  • {{language}} - Selected language
  • {{country}} - Country context
  • {{useCase}} - Use case (general, healthcare, etc.)
  • {{complexityLevel}} - Complexity setting
  • {{precisionRecallBias}} - Bias value (0-1)
  • {{existingPattern}} - Current pattern (for refinement)
  • {{validExamples}} - Positive examples
  • {{invalidExamples}} - Negative examples

Adding to Presets

After creating an entity:

  • You can add it to existing presets
  • Or create a new preset with the entity
  • Entities in presets are automatically used when the preset is selected

Support

For additional help:

Last Updated: December 30, 2025

Token System - anonymize.today

Last Updated: January 1, 2025
Classification: PUBLIC

Table of Contents

  1. Overview
  2. Plan Allocations
  3. Token Cost Formulas
  4. Operation Costs
  5. Token Management
  6. Examples
  7. FAQ

Overview

anonymize.today uses a token-based system to track and charge for platform usage. Tokens are consumed when you perform operations like analyzing text, anonymizing data, creating AI-powered entities, or using batch processing.

Key Concepts

  • Token Balance: Your current available tokens
  • Token Cycle: The period during which your tokens are valid (30-31 days depending on plan)
  • Token Allocation: Tokens automatically added to your account at the start of each cycle
  • Token Top-ups: Additional tokens you can purchase (Basic+ plans only)

Plan Allocations

PlanTokens per CycleCycle DurationTop-ups AvailablePrice
Free300 tokens30 days❌ NoFree
Basic500 tokens31 days✅ Yes (+200 for €1)€3/month
Pro2,000 tokens31 days❌ No€9/month
Business10,000 tokens31 days❌ No€29/month

Cycle Reset

  • Tokens reset automatically at the start of each cycle
  • Unused tokens from the previous cycle are not carried over
  • New tokens are allocated immediately when the cycle starts
  • Cycle dates are shown in Settings → Tokens tab

Token Cost Formulas (v4.3.0+)

Note: As of v4.3.0, token cost formulas can be configured by administrators through the Plan Management GUI. The formulas below represent the default configuration. All costs are reduced by a configurable reduction factor (default: 50%).

Database-Driven Configuration

Token cost coefficients are now stored in the database and can be adjusted without code changes:

  • Reduction Factor: Applied to all costs (default: 0.5 = 50% reduction)
  • Analyze Coefficients: Base cost and multipliers for text length, entities enabled, entities found
  • Apply Coefficients: Base cost and multipliers for operations, encryption, entities found, text length
  • AI Entity Creation: Fixed cost per AI operation (default: 50 tokens)

Administrators can view and modify these values in Admin Dashboard → Settings → Plan Pricing → Token Costs tab.

Token Cost Formulas (Default Configuration)

All token costs are calculated using formulas that consider text length, entity counts, and operation types. All costs are reduced by 50% from the base formula (applied after calculation).

Base Formulas (Before 50% Reduction)

Analyze Operation

PUT_analyze = 2 + 1.0 × text_k + 0.2 × entities_enabled + 0.1 × entities_found

Where:

  • text_k = text length in thousands of characters (rounded up)
  • entities_enabled = number of entity types selected for detection
  • entities_found = number of entities actually detected

Final Cost: Math.ceil(PUT_analyze × 0.5)

Apply Operation (Anonymization)

PUT_apply = 1 + 0.2 × ops_count + 0.8 × encrypt_count + 0.1 × entities_found + 0.2 × text_k

Where:

  • text_k = text length in thousands of characters (rounded up)
  • ops_count = number of anonymization operations performed
  • encrypt_count = number of encryption operations (higher cost)
  • entities_found = number of entities processed

Final Cost: Math.ceil(PUT_apply × 0.5)

Full Anonymize Operation

When anonymizing without pre-existing analyzer results:

PUT_total_full = PUT_analyze + PUT_apply

Apply-Only Anonymize Operation

When anonymizing with pre-existing analyzer results:

PUT_total_apply_only = PUT_apply

(Only the apply cost is charged, not the analyze cost)

Deanonymize Operation

PUT_deanonymize = 1 + 0.6 × decrypt_count + 0.1 × entities_found + 0.2 × text_k

Where:

  • text_k = text length in thousands of characters (rounded up)
  • decrypt_count = number of decryption operations performed
  • entities_found = number of encrypted entities found

Final Cost: Math.ceil(PUT_deanonymize × 0.5)

Batch Processing

Each text in the batch is charged using the analyze formula:

Cost per text = PUT_analyze
Total cost = SUM(PUT_analyze for each text)

AI Entity Creation

Fixed cost per AI operation:

Cost = 50 tokens

This applies to:

  • Pattern generation (3 variations)
  • Pattern refinement
  • Pattern validation

Operation Costs

Typical Costs (Examples)

Example 1: Analyze Short Text

  • Text: "John Doe lives in New York" (28 characters)
  • Entities enabled: 3 (PERSON, LOCATION, EMAIL_ADDRESS)
  • Entities found: 2 (PERSON, LOCATION)
  • Calculation:
    • text_k = 1 (28 chars = 1k)
    • PUT_analyze = 2 + 1.0 × 1 + 0.2 × 3 + 0.1 × 2 = 2 + 1 + 0.6 + 0.2 = 3.8
    • Final = Math.ceil(3.8 × 0.5) = 2 tokens

Example 2: Analyze Long Text

  • Text: 5,000 characters
  • Entities enabled: 5
  • Entities found: 15
  • Calculation:
    • text_k = 5
    • PUT_analyze = 2 + 1.0 × 5 + 0.2 × 5 + 0.1 × 15 = 2 + 5 + 1 + 1.5 = 9.5
    • Final = Math.ceil(9.5 × 0.5) = 5 tokens

Example 3: Full Anonymize

  • Text: 2,000 characters
  • Entities enabled: 4
  • Entities found: 8
  • Operations: 6 (replace, hash, mask)
  • Encryptions: 2
  • Calculation:
    • Analyze: PUT_analyze = 2 + 1.0 × 2 + 0.2 × 4 + 0.1 × 8 = 2 + 2 + 0.8 + 0.8 = 5.6
    • Apply: PUT_apply = 1 + 0.2 × 6 + 0.8 × 2 + 0.1 × 8 + 0.2 × 2 = 1 + 1.2 + 1.6 + 0.8 + 0.4 = 5.0
    • Total: 5.6 + 5.0 = 10.6
    • Final = Math.ceil(10.6 × 0.5) = 6 tokens

Example 4: Apply-Only Anonymize

  • Text: 1,000 characters
  • Entities found: 5
  • Operations: 3
  • Encryptions: 1
  • Calculation:
    • PUT_apply = 1 + 0.2 × 3 + 0.8 × 1 + 0.1 × 5 + 0.2 × 1 = 1 + 0.6 + 0.8 + 0.5 + 0.2 = 3.1
    • Final = Math.ceil(3.1 × 0.5) = 2 tokens

Example 5: Deanonymize

  • Text: 1,500 characters
  • Decrypt operations: 4
  • Entities found: 4
  • Calculation:
    • text_k = 2
    • PUT_deanonymize = 1 + 0.6 × 4 + 0.1 × 4 + 0.2 × 2 = 1 + 2.4 + 0.4 + 0.4 = 4.2
    • Final = Math.ceil(4.2 × 0.5) = 3 tokens

Example 6: AI Entity Creation

  • Operation: Generate 3 pattern variations
  • Cost: 50 tokens (fixed)

Example 7: Batch Processing

  • Texts: 3 texts of 1,000 characters each
  • Entities enabled: 3
  • Entities found per text: 2, 3, 1
  • Calculation:
    • Text 1: PUT_analyze = 2 + 1.0 × 1 + 0.2 × 3 + 0.1 × 2 = 3.8 → 2 tokens
    • Text 2: PUT_analyze = 2 + 1.0 × 1 + 0.2 × 3 + 0.1 × 3 = 3.9 → 2 tokens
    • Text 3: PUT_analyze = 2 + 1.0 × 1 + 0.2 × 3 + 0.1 × 1 = 3.7 → 2 tokens
    • Total: 6 tokens

Cost Summary Table

OperationBase Cost RangeTypical Cost (after 50% reduction)
Analyze (short text)2-5 tokens1-3 tokens
Analyze (long text)5-20 tokens3-10 tokens
Anonymize (apply-only)2-10 tokens1-5 tokens
Anonymize (full)4-20 tokens2-10 tokens
Deanonymize2-8 tokens1-4 tokens
Batch (per text)Same as analyzeSame as analyze
AI Entity Creation50 tokens50 tokens (fixed)

Token Management

Viewing Your Token Balance

  1. Go to Settings → Tokens tab
  2. View your current balance, total allocation, and usage
  3. See your cycle dates and remaining days

Token Top-ups (Basic Plan Only)

  1. Go to Settings → Billing tab
  2. Click "Purchase Top-up"
  3. Select amount: +200 tokens for €1
  4. Choose payment method (PayPal or Stripe)
  5. Complete secure checkout
  6. Tokens are added immediately to your balance

Important Notes:

  • Top-ups are exclusive to the Basic plan (as of v4.1.0)
  • Pro and Business plans include sufficient tokens and cannot purchase top-ups
  • Top-up tokens expire at the end of your current billing cycle
  • Payment is processed securely via PayPal or Stripe
  • You'll receive an email confirmation after successful purchase

Token Cycle Reset

  • Tokens automatically reset at the start of each cycle
  • You'll receive your plan's allocation (300/500/2000/10000 tokens)
  • Unused tokens from the previous cycle are not carried over
  • Cycle dates are shown in Settings → Tokens

Insufficient Tokens

If you don't have enough tokens for an operation:

  1. Error Message: "Insufficient tokens" with required amount
  2. Options:
    • Wait for cycle reset (if close to cycle end)
    • Purchase top-up (Basic+ plans)
    • Upgrade to a higher plan
    • Reduce text length or entity selection

Examples

Scenario 1: Free Plan User

Plan: Free (300 tokens / 30 days)
Usage: Analyzing documents daily

Typical Usage:

  • 10 analyze operations per day × 3 tokens = 30 tokens/day
  • Monthly: 30 × 30 = 900 tokens needed
  • Result: Not enough tokens on Free plan

Recommendation: Upgrade to Basic plan (500 tokens) or Pro plan (2,000 tokens)

Scenario 2: Basic Plan User

Plan: Basic (500 tokens / 31 days)
Usage: Mix of analyze and anonymize

Typical Usage:

  • 5 analyze operations × 3 tokens = 15 tokens
  • 3 anonymize operations × 5 tokens = 15 tokens
  • Daily: 30 tokens
  • Monthly: 30 × 31 = 930 tokens needed
  • Result: Need top-ups or upgrade

Options:

  • Purchase 2 top-ups (+400 tokens) = 900 total tokens
  • Upgrade to Pro plan (2,000 tokens)

Scenario 3: Pro Plan User

Plan: Pro (2,000 tokens / 31 days)
Usage: Heavy usage with AI entity creation

Typical Usage:

  • 20 analyze operations × 5 tokens = 100 tokens
  • 10 anonymize operations × 6 tokens = 60 tokens
  • 5 AI entity creations × 50 tokens = 250 tokens
  • Daily: 410 tokens
  • Monthly: 410 × 31 = 12,710 tokens needed
  • Result: Need top-ups or upgrade to Business

Options:

  • Purchase 54 top-ups (+10,800 tokens) = 12,800 total tokens
  • Upgrade to Business plan (10,000 tokens + top-ups)

FAQ

Q: Do unused tokens carry over to the next cycle?

A: No. Unused tokens are reset at the start of each cycle. You receive your plan's full allocation at the beginning of each cycle.

Q: Can I get a refund for unused tokens?

A: No. Tokens are non-refundable. However, you can use them before the cycle ends.

Q: How are tokens deducted?

A: Tokens are deducted after a successful operation. If an operation fails, no tokens are charged.

Q: What happens if I run out of tokens mid-operation?

A: The operation will fail with an "Insufficient tokens" error. No tokens are deducted for failed operations.

Q: Can I see my token usage history?

A: Yes. Go to Settings → Tokens tab to see your transaction history and usage statistics.

Q: Why do encryption operations cost more?

A: Encryption operations require more computational resources and are charged at 0.8 × encrypt_count (vs 0.2 × ops_count for other operations).

Q: Why is there a 50% reduction in costs?

A: Token costs were reduced by 50% in version 3.1.8 to make the platform more affordable. All formulas include this reduction.

Q: How do I estimate costs before running an operation?

A: The platform shows estimated token costs before you run operations. The estimate is based on text length and selected entities.

Q: Can I use tokens from multiple plans?

A: No. You can only use tokens from your current plan. Upgrading/downgrading changes your allocation immediately.

Q: What happens to my tokens if I cancel my subscription?

A: You'll be downgraded to the Free plan. Any remaining tokens from your paid plan are lost. You'll receive 300 tokens on the Free plan at the next cycle.

Cost Optimization Tips

Reduce Token Costs

  1. Use Presets: Presets help you select the right entities, reducing unnecessary detections
  2. Analyze First: Use the analyzer before anonymizing to see what will be detected
  3. Apply-Only Anonymize: If you already have analyzer results, use "Use in Anonymizer" to avoid double charging
  4. Selective Entities: Only select entity types you actually need to detect
  5. Batch Processing: For multiple texts, use batch processing for better efficiency
  6. Monitor Usage: Check Settings → Tokens regularly to track your usage

Estimate Costs

The platform provides cost estimation before operations:

  • Analyzer: Shows estimated cost based on text length and selected entities
  • Anonymizer: Shows estimated cost based on operations and text length
  • Actual Cost: May vary slightly based on entities actually found

Additional Resources

Last Updated: January 1, 2025

Word Add-in User Manual

Last Updated: January 1, 2025
Classification: PUBLIC

Table of Contents

  1. Introduction
  2. Getting Started
  3. Installation
  4. Authentication
  5. Features Overview
  6. Using the Add-in
  7. Settings & Configuration
  8. Token System & Costs
  9. Plans & Pricing
  10. Troubleshooting
  11. Security & Privacy
  12. FAQ

Introduction

Anonymize.Today is a Microsoft Word Add-in that helps you detect and anonymize personally identifiable information (PII) in your documents. The add-in integrates seamlessly with Microsoft Word and provides enterprise-grade privacy protection powered by advanced AI detection algorithms.

Key Benefits

  • Privacy-First: Protect sensitive information in documents
  • Easy to Use: Simple interface integrated into Microsoft Word
  • Secure: Browser-based authentication with automatic token management
  • Flexible: Support for multiple languages and entity types
  • Cost-Effective: Pay-as-you-go token system with free tier available

Getting Started

Prerequisites

  • Microsoft Word 2016 or later (Windows, macOS, or Word Online)
  • Office 365 subscription (recommended)
  • Internet connection
  • An account on anonymize.today

System Requirements

  • Word Versions: Word 2016+, Word 2019, Word 2021, Word Online, Office 365
  • Platforms: Windows, macOS, Web
  • Network: HTTPS access to anonymize.today

Installation

The Anonymize.Today Word Add-in can be installed in several ways depending on your organization's setup and requirements. Choose the method that best fits your scenario.

Installation Methods Overview

MethodBest ForAdmin RequiredDeployment Scope
Add from URLIndividual users, testingNoSingle user
Office 365 Admin CenterOrganizations, enterpriseYesEntire organization or specific groups
Centralized DeploymentLarge organizationsYesManaged deployment

Method 1: Add from URL (Individual Installation)

This method is ideal for individual users who want to install the add-in on their own Word installation.

Prerequisites

  • Microsoft Word 2016 or later (Windows, macOS, or Word Online)
  • Office 365 subscription or Office 2019/2021
  • Internet connection

Step-by-Step Instructions

For Word Desktop (Windows/Mac):

  1. Open Microsoft Word
  2. Go to Insert → Get Add-ins (or Add-ins → Get Add-ins)
  3. In the Add-ins dialog, click My Add-ins tab
  4. At the bottom, click Add a Custom Add-in → Add from URL
  5. Enter the manifest URL: 
    https://anonymize.today/wordaddin/manifest.xml
  6. Click Add
  7. If prompted, click Trust this add-in to allow the add-in to run
  8. The add-in will appear in your ribbon under the Anonymize.Today group

For Word Online:

  1. Open Word Online in your browser
  2. Go to Insert → Add-ins → Get Add-ins
  3. Click My Add-ins tab
  4. Click Add a Custom Add-in → Add from URL
  5. Enter the manifest URL: 
    https://anonymize.today/wordaddin/manifest.xml
  6. Click Add
  7. The add-in will appear in the ribbon

Verification

After installation, verify the add-in is working:

  • Look for the Anonymize.Today group in the Home tab
  • You should see three buttons:
    • Anonymize Selection - Anonymizes selected text
    • Anonymize Document - Anonymizes entire document
    • Settings - Opens the task pane

Troubleshooting

Issue: "Add-in failed to load" or "Manifest not found"

  • Solution: Verify the manifest URL is correct and accessible
  • Check your internet connection
  • Try accessing https://anonymize.today/wordaddin/manifest.xml in your browser

Issue: "Add-in blocked by organization policy"

  • Solution: Your organization may have policies preventing custom add-ins
  • Contact your IT administrator for assistance
  • Consider using Method 2 (Admin Center deployment)

Issue: Add-in doesn't appear in ribbon

  • Solution: Close and reopen Word
  • Check if the add-in is listed in File → Options → Add-ins → COM Add-ins

Method 2: Office 365 Admin Center (Organization-Wide Deployment)

This method is ideal for organizations that want to deploy the add-in to all users or specific groups through the Microsoft 365 Admin Center.

Prerequisites

  • Microsoft 365 Admin account with Global Administrator or Exchange Administrator role
  • Access to admin.microsoft.com
  • Organization must allow custom add-ins

Step-by-Step Instructions

  1. Access Admin Center

  2. Navigate to Integrated Apps

    • Click Settings → Integrated apps (or Settings → Add-ins)
    • Click Upload custom apps or Deploy Add-in

  3. Upload Manifest

    • Click Upload custom apps → Upload a manifest file
    • Select Add from URL
    • Enter the manifest URL: 
      https://anonymize.today/wordaddin/manifest.xml
    • Click Next

  4. Configure Deployment

    • App Name: Anonymize.Today (auto-filled)
    • Deployment Type: Choose one:
      • All users: Deploys to everyone in your organization
      • Specific groups/users: Deploy to selected groups or users
    • Assignment: Select users or groups (if using specific deployment)
    • Permissions: Review and accept required permissions

  5. Review and Deploy

    • Review the deployment settings
    • Click Deploy or Save
    • Wait for deployment to complete (may take a few minutes)

  6. Verify Deployment

    • Users will see the add-in appear in Word automatically
    • No action required from end users
    • Add-in appears in Insert → Get Add-ins → Admin Managed

Deployment Options

Option A: Deploy to All Users

  • Best for: Organizations where all users need the add-in
  • Users receive the add-in automatically
  • No user action required

Option B: Deploy to Specific Groups

  • Best for: Organizations with selective deployment needs
  • Deploy to:
    • Security groups
    • Distribution groups
    • Individual users
  • Users in selected groups receive the add-in automatically

Option C: Make Available (User Choice)

  • Best for: Organizations that want to offer the add-in but not force installation
  • Add-in appears in Admin Managed section
  • Users can install it themselves
  • No automatic installation

Admin Configuration

Required Permissions:

  • The add-in requires ReadWriteDocument permission
  • This allows the add-in to read and modify Word documents
  • Required for anonymization functionality

Update Management:

  • When you update the add-in, changes are automatically deployed
  • Users receive updates automatically
  • No manual update required

Removal:

  • To remove the add-in, go to Integrated apps
  • Find "Anonymize.Today" in the list
  • Click Remove or Uninstall
  • Confirm removal

Troubleshooting for Admins

Issue: "Cannot upload manifest"

  • Solution: Verify you have Global Administrator or Exchange Administrator role
  • Check that custom add-ins are enabled in your organization
  • Verify the manifest URL is accessible

Issue: "Deployment failed"

  • Solution: Check deployment logs in Admin Center
  • Verify user/group assignments are correct
  • Ensure users have valid Office 365 licenses

Issue: "Users not seeing add-in"

  • Solution: Wait 15-30 minutes for propagation
  • Ask users to restart Word
  • Check if add-in is in Admin Managed section

Method 3: Centralized Deployment via PowerShell (Advanced)

For organizations using PowerShell for Office 365 management, the add-in can be deployed using the Office 365 Management API.

Prerequisites

  • Office 365 PowerShell module installed
  • Global Administrator credentials
  • Access to Exchange Online PowerShell

PowerShell Commands

# Connect to Exchange Online
Connect-ExchangeOnline

# Create app manifest
$manifestUrl = "https://anonymize.today/wordaddin/manifest.xml"

# Deploy to all users
New-App -OrganizationApp -Url $manifestUrl -DefaultStateForUser Enabled

# Or deploy to specific users
$users = @("[email protected]", "[email protected]")
New-App -OrganizationApp -Url $manifestUrl -DefaultStateForUser Enabled -UserList $users

Verification

# Check deployment status
Get-App -OrganizationApp | Where-Object { $_.DisplayName -eq "Anonymize.Today" }

Installation Verification Checklist

After installation (any method), verify:

  • Add-in appears in Word ribbon (Home tab → Anonymize.Today group)
  • Three buttons are visible: Anonymize Selection, Anonymize Document, Settings
  • Clicking Settings opens the task pane
  • Task pane loads without errors
  • Sign In button is visible (if not authenticated)
  • No error messages in browser console (F12)

Updating the Add-in

For Individual Installations (Method 1):

  • Updates are automatic when you restart Word
  • Office checks the manifest URL for updates
  • No manual update required

For Admin Deployments (Method 2 & 3):

  • Updates are managed by the admin
  • When admin updates the deployment, users receive updates automatically
  • Users may need to restart Word to see updates

Removing the Add-in

Individual Users:

  1. Go to File → Options → Add-ins
  2. Select COM Add-ins from the dropdown
  3. Find "Anonymize.Today"
  4. Uncheck the box or click Remove

Admins:

  1. Go to Admin Center → Integrated apps
  2. Find "Anonymize.Today"
  3. Click Remove or Uninstall
  4. Confirm removal

Authentication

The Anonymize.Today Word Add-in uses Browser Single Sign-On (SSO) for seamless authentication. This means you sign in once using your browser, and the add-in automatically uses your existing session.

How Browser SSO Works

  1. No Manual Token Copying: Unlike traditional add-ins, you don't need to copy tokens or API keys
  2. Leverages Browser Session: If you're already signed in to anonymize.today in your browser, authentication is instant
  3. Automatic Token Management: The add-in handles token refresh automatically
  4. Secure: Tokens are stored securely and rotated regularly

First-Time Sign-In (Step-by-Step)

Step 1: Open the Add-in

  1. Open Microsoft Word
  2. Click the Settings button in the Anonymize.Today ribbon group
    • Alternatively, the task pane may open automatically
  3. The task pane will appear on the right side of Word

Step 2: Initiate Sign-In

  1. In the task pane header, you'll see a Sign In button
  2. Click Sign In
  3. A browser dialog window will open
    • Note: If pop-ups are blocked, you'll need to allow them for this site

Step 3: Authentication Process

Scenario A: Already Signed In (Automatic SSO)

If you're already signed in to anonymize.today in your browser:

  1. The dialog will detect your existing session
  2. You'll see a message: "Continue as [[email protected]]"
  3. Click Continue or Sign In
  4. The dialog will automatically generate tokens for the add-in
  5. The dialog closes automatically
  6. You'll see your account information in the task pane
  7. Status: ✅ Authenticated (green indicator)

Scenario B: Not Signed In (Manual Login)

If you're not signed in:

  1. The dialog will show the login form
  2. Enter your Email address
  3. Enter your Password
  4. Click Sign In
  5. If you have 2FA enabled:
    • Enter your verification code (TOTP app or email code)
    • Click Verify & Sign In
  6. Once authenticated, tokens are generated automatically
  7. The dialog closes automatically
  8. You'll see your account information in the task pane
  9. Status: ✅ Authenticated (green indicator)

Step 4: Verify Authentication

After signing in, verify you're authenticated:

  • ✅ Header Status: Green indicator shows "Authenticated"
  • ✅ User Email: Your email appears in the header
  • ✅ Sign Out Button: Visible in header (replaces Sign In)
  • ✅ Account Tab: Shows your plan and token balance
  • ✅ Buttons Enabled: Anonymize buttons are now active

Automatic Authentication (Subsequent Sessions)

Once you've signed in once, the add-in remembers your session:

  1. Token Storage: Tokens are stored securely in Office settings
  2. Automatic Refresh: Tokens are refreshed automatically before expiration
  3. No Re-authentication: You won't need to sign in again unless:
    • You explicitly sign out
    • Your password is changed
    • Tokens expire and refresh fails
    • You clear Office settings

How Automatic Refresh Works

  • Access Token: Valid for 1 hour, refreshed automatically
  • Refresh Token: Valid for 30 days, used to get new access tokens
  • Background Refresh: Happens automatically, no user interaction needed
  • Seamless Experience: You won't notice token refreshes happening

Sign Out

To sign out of the add-in:

  1. Click Sign Out in the task pane header
  2. A confirmation may appear (depending on your settings)
  3. Your tokens are revoked on the server
  4. Local tokens are cleared
  5. Status: ❌ Not authenticated (red indicator)
  6. You'll need to sign in again to use the add-in

When to Sign Out:

  • Using a shared computer
  • Switching accounts
  • Security concerns
  • Troubleshooting authentication issues

Authentication Status Indicators

The add-in shows your authentication status with color-coded indicators:

IndicatorColorMeaningAction Required
Authenticated🟢 GreenSigned in and readyNone - you can use all features
Not Authenticated🔴 RedNot signed inClick "Sign In" to authenticate
Connected🔵 BlueAuthenticated and API connectedNone - everything working

Where to See Status:

  • Header: Status indicator next to app title
  • Connection Tab: Detailed connection status
  • Button States: Disabled buttons indicate not authenticated

Troubleshooting Authentication

Issue: "Sign In" Button Doesn't Open Dialog

Possible Causes:

  • Pop-up blocker is active
  • Browser security settings
  • Office Dialog API not supported

Solutions:

  1. Allow Pop-ups:
    • Check browser settings
    • Allow pop-ups for anonymize.today
    • Try a different browser
  2. Check Office Version:
    • Ensure you're using Word 2016+ or Office 365
    • Word Online may have different behavior
  3. Restart Word:
    • Close and reopen Word
    • Try again

Issue: "Authentication Failed" or "Invalid Credentials"

Possible Causes:

  • Incorrect email or password
  • Account locked (too many failed attempts)
  • 2FA code incorrect
  • Account doesn't exist

Solutions:

  1. Verify Credentials:
    • Double-check email and password
    • Try signing in on the website first: anonymize.today
  2. Account Locked:
    • Wait 30 minutes if locked
    • Contact support if persistent
  3. 2FA Issues:
    • Verify code from authenticator app
    • Request new email code if needed
    • Check code hasn't expired

Issue: "Session Expired" or "Token Invalid"

Possible Causes:

  • Tokens expired and refresh failed
  • Password changed
  • Server-side token revocation

Solutions:

  1. Sign Out and Sign In Again:
    • Click "Sign Out"
    • Click "Sign In" again
    • Complete authentication
  2. Check Internet Connection:
    • Verify you're connected to the internet
    • Check firewall settings
  3. Clear Office Settings (if persistent):
    • Go to File → Options → Add-ins
    • Remove and re-add the add-in

Issue: Dialog Opens But Shows Error

Possible Causes:

  • Server issues
  • Network problems
  • CORS errors

Solutions:

  1. Check Server Status:
  2. Check Browser Console:
    • Press F12 in the dialog
    • Look for error messages
    • Report errors to support
  3. Try Different Browser:
    • If using Word Desktop, try Word Online
    • Or vice versa

Issue: "Already Signed In" But Add-in Shows Not Authenticated

Possible Causes:

  • Browser session expired
  • Token refresh failed
  • Office settings cleared

Solutions:

  1. Refresh Browser Session:
    • Sign out and sign in on the website
    • Then try add-in sign-in again
  2. Clear and Re-authenticate:
    • Sign out of add-in
    • Sign in again
  3. Check Token Storage:
    • Verify Office settings are not cleared
    • Check if other add-ins work

Security Best Practices

  1. Sign Out on Shared Computers:

    • Always sign out when using shared or public computers
    • Prevents unauthorized access to your account

  2. Keep Browser Session Active:

    • Don't sign out of anonymize.today in your browser
    • This enables seamless SSO

  3. Monitor Token Usage:

    • Check your account for unusual activity
    • Review token usage in Account tab

  4. Report Suspicious Activity:

    • If you notice unauthorized access, sign out immediately
    • Change your password
    • Contact support

Authentication Flow Diagram

User Clicks "Sign In"
        ↓
Office Dialog Opens
        ↓
Check Browser Session
        ↓
    ┌───┴───┐
    │       │
  Yes      No
    │       │
    ↓       ↓
Auto-login  Show Login Form
    │       │
    │       User Enters Credentials
    │       │
    │       ↓
    │   2FA? (if enabled)
    │       │
    │       ↓
    └───→ Generate Tokens
            │
            ↓
    Store Tokens Securely
            │
            ↓
    Close Dialog
            │
            ↓
    Update UI (Authenticated)
            │
            ↓
    Ready to Use!

Frequently Asked Questions (Authentication)

Q: Do I need to sign in every time I open Word?
A: No, once you sign in, the add-in remembers your session. You only need to sign in again if you sign out or if your session expires.

Q: What happens if I'm already signed in to anonymize.today in my browser?
A: The add-in will automatically detect your session and authenticate you without requiring you to enter credentials again.

Q: Can I use the add-in without an anonymize.today account?
A: No, you need an account to use the add-in. You can create a free account at anonymize.today.

Q: What if I forget my password?
A: Use the "Forgot Password" link in the login dialog, or go to anonymize.today to reset your password.

Q: Does the add-in store my password?
A: No, the add-in never stores your password. It only stores secure tokens that are used for API authentication.

Q: Can I use the add-in offline?
A: No, the add-in requires an internet connection to communicate with the anonymize.today servers.

Q: What if I have 2FA enabled?
A: The login dialog will prompt you for your 2FA code (from your authenticator app or email) after you enter your password.

Q: Can I use multiple accounts?
A: You can sign out and sign in with a different account, but the add-in only supports one active session at a time.

Features Overview

Core Features

  1. Anonymize Selection

    • Select text in your document
    • Click Anonymize Selection
    • Detects and anonymizes PII in the selected text

  2. Anonymize Document

    • Click Anonymize Document
    • Processes the entire document
    • Shows progress for large documents

  3. Preview Mode

    • Review detected entities before anonymization
    • Approve or reject individual entities
    • Customize anonymization per entity

Supported Entity Types

The add-in can detect and anonymize:

  • Personal Information: Names, Email Addresses, Phone Numbers
  • Financial: Credit Card Numbers, IBAN Codes
  • Location: Addresses, Geographic Locations
  • Identification: Social Security Numbers, Driver Licenses, Passport Numbers
  • Medical: Medical License Numbers, UK NHS Numbers
  • Technical: IP Addresses, URLs
  • Temporal: Dates and Times
  • Custom: Your own custom entity patterns (Basic plan and above)

Supported Languages

The add-in supports all 15 languages supported by the Presidio backend:

European Languages:

  • English (en)
  • German (de) - Deutsch
  • Spanish (es) - Español
  • French (fr) - Français
  • Italian (it) - Italiano
  • Portuguese (pt) - Português
  • Dutch (nl) - Nederlands
  • Polish (pl) - Polski

Additional Languages:

  • Russian (ru) - Русский
  • Japanese (ja) - 日本語
  • Chinese (zh) - 中文
  • Korean (ko) - 한국어
  • Arabic (ar) - العربية
  • Hindi (hi) - हिन्दी
  • Turkish (tr) - Türkçe

Note: Language selection affects which entity types can be detected. Some languages have better support for certain entity types than others.

Using the Add-in

Basic Workflow

  1. Open your document in Microsoft Word
  2. Sign in to the add-in (if not already authenticated)
  3. Select text you want to anonymize, or anonymize the entire document
  4. Choose settings:
    • Language for detection
    • Entity types to detect
    • Anonymization method
  5. Click Anonymize
  6. Review results (if preview mode is enabled)
  7. Apply anonymization

Anonymization Methods

  • Replace: Replace PII with <ENTITY_TYPE> (e.g., <PERSON>)
  • Mask: Replace with asterisks (***)
  • Redact: Remove PII completely (blank)
  • Hash: Replace with hash value (Pro/Business plans)
  • Encrypt: Encrypt PII with AES encryption (Basic plan and above)

Preview Mode

When enabled, preview mode allows you to:

  • See all detected entities before anonymization
  • Review entity types and locations
  • Approve or reject individual entities
  • Customize anonymization per entity

To enable Preview Mode:

  1. Open Settings tab
  2. Check Enable Preview Mode
  3. Save settings

Settings & Configuration

Anonymizer Settings Tab

Language Selection

  • Choose the language for PII detection
  • Affects which entity types can be detected
  • Default: English

Anonymization Method

  • Select how PII should be anonymized
  • Options: Replace, Mask, Redact, Hash, Encrypt
  • Default: Replace

Entity Types

  • Select which types of PII to detect
  • Check/uncheck entity types as needed
  • Default: All common entity types

Presets

  • Load Presets: Select a saved preset from your account
  • Presets include pre-configured entity types, language, and settings
  • Available for Basic plan and above
  • Personal presets are synced from your anonymize.today account

Account & Tokens Tab

Plan Information

  • View your current plan (Free, Basic, Pro, Business)
  • See plan features and limits

Token Balance

  • Current Balance: Tokens available for use
  • Progress Bar: Visual representation of token usage
  • Used/Total: Detailed token statistics
  • Buy Tokens: Link to purchase additional tokens (Basic plan)

Personal API Token

  • View your personal API token
  • Copy: Copy token to clipboard
  • Regenerate: Create a new token (invalidates old token)
  • Use this token for API access (Basic plan and above)

Connection Tab

  • Connection Status: Shows authentication and API connection status
  • Test Connection: Verify connectivity to anonymize.today services

Token System & Costs

How Tokens Work

Tokens are consumed when you use anonymization features. Each operation has a token cost based on:

  • Text length (per 1000 characters)
  • Number of entity types enabled
  • Number of entities found
  • Anonymization method used

Token Cost Formulas

Analysis Cost

Cost = (2 + 1.0 × text_k + 0.2 × entities_enabled + 0.1 × entities_found) × 0.5

Where:

  • text_k = text length in thousands (rounded up)
  • entities_enabled = number of entity types selected
  • entities_found = number of PII entities detected

Anonymization Cost (Apply)

Cost = (1 + 0.2 × ops_count + 0.8 × encrypt_count + 0.1 × entities_found + 0.2 × text_k) × 0.5

Where:

  • ops_count = number of anonymization operations
  • encrypt_count = number of encryption operations (if using encrypt method)

Full Anonymization Cost

Cost = Analysis Cost + Apply Cost

Example Costs

Example 1: Small Document (500 characters, 3 entities found)

  • Text: 500 chars = 1k
  • Entities enabled: 5
  • Entities found: 3
  • Analysis cost: (2 + 1.0 × 1 + 0.2 × 5 + 0.1 × 3) × 0.5 = 2.15 tokens (rounded to 3)
  • Apply cost: (1 + 0.2 × 3 + 0.1 × 3 + 0.2 × 1) × 0.5 = 1.05 tokens (rounded to 2)
  • Total: ~5 tokens

Example 2: Large Document (10,000 characters, 20 entities found)

  • Text: 10,000 chars = 10k
  • Entities enabled: 10
  • Entities found: 20
  • Analysis cost: (2 + 1.0 × 10 + 0.2 × 10 + 0.1 × 20) × 0.5 = 8 tokens
  • Apply cost: (1 + 0.2 × 20 + 0.1 × 20 + 0.2 × 10) × 0.5 = 4.5 tokens (rounded to 5)
  • Total: ~13 tokens

Token Deduction

  • Tokens are deducted after successful anonymization
  • If you run out of tokens, you'll see an error message
  • Purchase additional tokens or upgrade your plan to continue

Plans & Pricing

Free Plan

  • Price: €0/month
  • Tokens: 300 tokens per 30-day cycle
  • Features:
    • Basic anonymization (Replace, Mask, Redact)
    • Personal presets and entities
    • Limited to analyzer and anonymizer features
  • Best for: Occasional users, testing, small documents

Basic Plan

  • Price: €3/month
  • Tokens: 500 tokens per 31-day cycle
  • Top-ups: 200 tokens for €1 (available)
  • Features:
    • All Free plan features
    • Batch processing
    • Deanonymization
    • Encryption (AES)
    • API access
    • Public presets and entities
    • AI entity creation
    • Token top-ups
  • Best for: Regular users, small businesses, developers

Pro Plan

  • Price: €9/month
  • Tokens: 2,000 tokens per 31-day cycle
  • Features:
    • All Basic plan features
    • Higher token allocation
    • Larger batch sizes (up to 500 items)
  • Best for: Power users, frequent processing

Business Plan

  • Price: €29/month
  • Tokens: 10,000 tokens per 31-day cycle
  • Features:
    • All Pro plan features
    • Maximum batch sizes (up to 5,000 items)
    • Highest token allocation
  • Best for: Enterprise users, high-volume processing

Plan Comparison

FeatureFreeBasicProBusiness
Monthly Tokens3005002,00010,000
Price/Month€0€3€9€29
Analyzer✅✅✅✅
Anonymizer✅✅✅✅
Batch Processing❌✅✅✅
Deanonymize❌✅✅✅
Encryption❌✅✅✅
API Access❌✅✅✅
Personal Presets✅✅✅✅
Public Presets❌✅✅✅
AI Entity Creation❌✅✅✅
Token Top-ups❌✅✅✅
Max Batch SizeN/A1005005,000

Upgrading Your Plan

  1. Go to the Account & Tokens tab in the add-in
  2. Click Buy Tokens or visit anonymize.today/app/settings?tab=billing
  3. Select your desired plan
  4. Complete payment via PayPal or Stripe
  5. Your plan will be activated immediately

Troubleshooting

Add-in Not Loading

Problem: Add-in doesn't appear in Word

Solutions:

  1. Verify manifest URL is correct: https://anonymize.today/wordaddin/manifest.xml
  2. Check internet connection
  3. Try removing and re-adding the add-in
  4. Clear Office cache: File → Options → Trust Center → Trust Center Settings → Trusted Add-in Catalogs

Authentication Issues

Problem: Can't sign in

Solutions:

  1. Ensure you have an account at anonymize.today
  2. Check browser pop-up blockers (Office Dialog API requires pop-ups)
  3. Verify HTTPS access to anonymize.today
  4. Try signing in through the web interface first
  5. Clear browser cookies and try again

Connection Errors

Problem: "Disconnected" or connection test fails

Solutions:

  1. Check internet connection
  2. Verify you're signed in
  3. Test connection using the Test Connection button
  4. Check firewall settings (HTTPS to anonymize.today must be allowed)
  5. Verify nginx/network configuration on your network

Token Errors

Problem: "Insufficient tokens" error

Solutions:

  1. Check your token balance in the Account & Tokens tab
  2. Wait for your next token cycle (tokens reset monthly)
  3. Purchase additional tokens (Basic plan and above)
  4. Upgrade to a higher plan for more tokens
  5. Optimize your settings (fewer entity types = lower cost)

Anonymization Not Working

Problem: No entities detected or anonymization fails

Solutions:

  1. Verify you've selected entity types in settings
  2. Check that the document language matches your language setting
  3. Ensure you have sufficient tokens
  4. Try with a smaller text selection first
  5. Check that preview mode isn't blocking the operation
  6. Verify your plan supports the requested features

Performance Issues

Problem: Slow processing or timeouts

Solutions:

  1. Large documents are processed in chunks automatically
  2. Reduce the number of entity types selected
  3. Process smaller sections at a time
  4. Check your internet connection speed
  5. Close other resource-intensive applications

Security & Privacy

Data Security

  • HTTPS Only: All communication is encrypted via HTTPS
  • No Data Storage: Your documents are never stored on our servers
  • In-Memory Processing: Text is processed in memory and discarded immediately
  • Token Security: Access tokens are stored in-memory only (never persisted)
  • Refresh Tokens: Stored securely in database, automatically rotated

Authentication Security

  • Browser SSO: Uses your existing browser session for seamless authentication
  • Short-Lived Tokens: Access tokens expire after 1 hour
  • Automatic Refresh: Tokens are automatically refreshed before expiration
  • Token Revocation: Tokens are revoked on password change or explicit sign-out
  • Rate Limiting: Authentication endpoints are rate-limited to prevent abuse

Privacy

  • No Tracking: We don't track your document content
  • Minimal Logging: Only error logs and usage statistics (no PII)
  • GDPR Compliant: Full compliance with GDPR regulations
  • Data Minimization: Only necessary data is transmitted

Best Practices

  1. Sign Out: Always sign out when using shared computers
  2. Token Management: Regenerate API tokens if compromised
  3. Network Security: Use secure networks when processing sensitive documents
  4. Review Results: Always review anonymization results before sharing documents

FAQ

General Questions

Q: Is the add-in free?
A: Yes, there's a free plan with 300 tokens per month. Paid plans start at €3/month.

Q: Do I need an internet connection?
A: Yes, the add-in requires an internet connection to communicate with anonymize.today services.

Q: Which Word versions are supported?
A: Word 2016+, Word 2019, Word 2021, Word Online, and Office 365.

Q: Can I use it offline?
A: No, the add-in requires an active internet connection for processing.

Token Questions

Q: How are tokens calculated?
A: Tokens are calculated based on text length, entity types enabled, and entities found. See Token System & Costs for details.

Q: What happens when I run out of tokens?
A: You'll see an error message. You can wait for your next token cycle, purchase top-ups (Basic plan), or upgrade your plan.

Q: Do unused tokens roll over?
A: No, tokens reset at the beginning of each cycle. Unused tokens are lost.

Q: Can I buy more tokens?
A: Yes, Basic plan users can purchase 200-token top-ups for €1 each.

Feature Questions

Q: What entity types can be detected?
A: See Supported Entity Types for the complete list. Custom entities are available on Basic plan and above.

Q: Can I create my own entity patterns?
A: Yes, Basic plan and above users can create custom entities with regex patterns.

Q: What languages are supported?
A: See Supported Languages for the complete list.

Q: Can I anonymize images?
A: No, the Word Add-in only processes text. Image redaction is available on the web platform.

Technical Questions

Q: How do I update the add-in?
A: Updates are automatic. The add-in checks for updates when loaded. You may need to reload Word to get the latest version.

Q: Why is my manifest.xml cached?
A: Office caches the manifest for performance. Clear the Office cache if you need to force an update.

Q: Can I use the add-in with other Office applications?
A: Currently, the add-in is only available for Microsoft Word.

Q: How do I report bugs or request features?
A: Visit anonymize.today and use the support/contact form.

Billing Questions

Q: How do I upgrade my plan?
A: Visit anonymize.today/app/settings?tab=billing or click "Buy Tokens" in the add-in.

Q: What payment methods are accepted?
A: PayPal and Stripe (credit/debit cards).

Q: Can I cancel my subscription?
A: Yes, you can cancel anytime. Your plan remains active until the end of the billing cycle.

Q: Do you offer refunds?
A: Refund policies are available on the pricing page. Contact support for specific cases.

Support & Resources

Getting Help

Additional Resources

  • API Documentation: Available for Basic plan and above users
  • Video Tutorials: Coming soon
  • Community Forum: Coming soon

Version Information

  • Current Version: 2.8.0
  • Last Updated: December 2025
  • Manifest URL: https://anonymize.today/wordaddin/manifest.xml

Changelog

Version 2.8.0 (Current)

  • ✅ Renamed to "Anonymize.Today"
  • ✅ Browser SSO authentication
  • ✅ Automatic token refresh
  • ✅ Account & Tokens tab
  • ✅ Preset integration
  • ✅ Improved UI/UX
  • ✅ Enhanced security headers
  • ✅ Refined CORS configuration

Previous Versions

See CHANGELOG.md for detailed version history.

Legal & Compliance

Terms of Service

By using the Anonymize.Today Word Add-in, you agree to our Terms of Service available at anonymize.today/terms.

Privacy Policy

Our Privacy Policy is available at anonymize.today/privacy.

GDPR Compliance

Anonymize.Today is fully GDPR compliant. We process data according to GDPR regulations and provide data export/deletion capabilities.

© 2025 Anonymize.Today. All rights reserved.

For the latest information and updates, visit anonymize.today.

Explore Other Documentation

Overview

Introduction to anonymize.today platform

Getting Started

Quick start guide and first steps

Technical Documentation

API, architecture, and developer resources

Security & Compliance

Security measures and compliance information

FAQ & Support

Frequently asked questions and troubleshooting