> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibedoc-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Watermark System

> Add professional text or image watermarks to your documents

## Overview

VibeDoc's advanced watermark system allows you to protect and brand your documents with customizable text or image watermarks. Choose from multiple display modes and patterns to create the perfect watermark for your needs.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vibedoc/images/watermark-demo.png" alt="Watermark Configuration" className="rounded-lg border" />

## Watermark Options

<CardGroup cols={3}>
  <Card title="Type" icon="layer-group">
    Choose between None, Text, or Image watermarks
  </Card>

  <Card title="Mode" icon="grid">
    Display as Single centered or Repeated across page
  </Card>

  <Card title="Pattern" icon="table-cells">
    Select Diagonal, Grid, or Sparse repeat patterns
  </Card>
</CardGroup>

## Text Watermarks

### Configuration Options

Add custom text watermarks with full typography control:

<AccordionGroup>
  <Accordion title="Font Settings">
    * **Font Family**: Choose from 100+ Google Fonts or system fonts
    * **Font Size**: Adjustable from 8pt to 120pt
    * **Font Weight**: Normal or Bold
    * **Font Style**: Normal or Italic
  </Accordion>

  <Accordion title="Appearance">
    * **Text Color**: Full color picker with hex support
    * **Rotation**: Rotate from -90° to 90° for diagonal layouts
    * **Opacity**: Control transparency from 0% to 100%
  </Accordion>
</AccordionGroup>

### Example Use Cases

```yaml theme={null}
Confidential Document:
  Text: "CONFIDENTIAL"
  Font: "Roboto Bold"
  Size: 72pt
  Color: #DC2626 (Red)
  Rotation: -45°
  Opacity: 15%
  Mode: Repeated
  Pattern: Diagonal

Draft Watermark:
  Text: "DRAFT - DO NOT DISTRIBUTE"
  Font: "Inter"
  Size: 48pt
  Color: #6B7280 (Gray)
  Rotation: 0°
  Opacity: 20%
  Mode: Single
```

## Image Watermarks

### Upload & Configuration

Add your logo or custom image as a watermark:

<Steps>
  <Step title="Upload Image">
    Upload directly or provide a URL to your watermark image (PNG, JPG, SVG supported)
  </Step>

  <Step title="Adjust Size">
    Control image size from 10% to 200% of the page area
  </Step>

  <Step title="Position">
    For single mode, choose from:

    * Center (default)
    * Top Left
    * Top Right
    * Bottom Left
    * Bottom Right
  </Step>

  <Step title="Set Opacity">
    Fine-tune transparency to blend with your content
  </Step>
</Steps>

### Image Specifications

<Note>
  **Recommended**: Use PNG images with transparency for best results. SVG format works great for logos.
</Note>

* **Max file size**: 5MB
* **Formats**: PNG, JPG, JPEG, SVG, WebP
* **Best practices**:
  * Use high-resolution images (300 DPI)
  * Square or horizontal aspect ratios work best
  * Transparent backgrounds blend better

## Repeat Patterns

<Info>
  Available only in **Repeated** mode for comprehensive page coverage.
</Info>

### Pattern Types

<CardGroup cols={3}>
  <Card title="Diagonal" icon="slash">
    Classic diagonal pattern at -45° angle

    **Best for**: Confidential stamps, draft markers
  </Card>

  <Card title="Grid" icon="table-cells">
    Dense regular grid pattern (3×3)

    **Best for**: Logo branding, copyright protection
  </Card>

  <Card title="Sparse" icon="table-cells-large">
    Spaced pattern (2×2) with breathing room

    **Best for**: Subtle branding, large watermarks
  </Card>
</CardGroup>

## Practical Examples

### 1. Company Branding

```yaml theme={null}
Watermark Type: Image
Mode: Repeated
Pattern: Grid
Image: company-logo.svg
Size: 40%
Opacity: 8%
```

<Tip>
  Low opacity (5-10%) keeps watermarks subtle but visible when needed.
</Tip>

### 2. Confidential Documents

```yaml theme={null}
Watermark Type: Text
Mode: Repeated
Pattern: Diagonal
Text: "CONFIDENTIAL"
Font: Roboto Bold
Size: 60pt
Color: #DC2626
Rotation: -45°
Opacity: 12%
```

### 3. Draft Versions

```yaml theme={null}
Watermark Type: Text
Mode: Single
Text: "DRAFT - v1.2.0"
Font: Inter
Size: 48pt
Color: #6B7280
Rotation: 0°
Opacity: 25%
```

### 4. Copyright Protection

```yaml theme={null}
Watermark Type: Image
Mode: Repeated
Pattern: Sparse
Image: copyright-mark.png
Size: 50%
Opacity: 15%
```

## Best Practices

<AccordionGroup>
  <Accordion title="Readability First">
    Keep opacity between 5-15% to ensure watermarks don't interfere with document content. Your watermark should be visible when looking for it, but not distract from the main content.
  </Accordion>

  <Accordion title="Consistent Branding">
    Use the same watermark configuration across similar document types for professional consistency. Save your settings as a template.
  </Accordion>

  <Accordion title="Text Length">
    Keep text watermarks short (1-3 words) for better visual impact. Longer text can become difficult to read at diagonal angles.
  </Accordion>

  <Accordion title="Image Quality">
    Use vector formats (SVG) for logos and high-resolution (300 DPI) raster images for photos. This ensures crisp watermarks at any size.
  </Accordion>
</AccordionGroup>

## Watermark in Export

<Warning>
  Watermarks are **permanently embedded** in PDF exports. Review your watermark carefully before exporting final documents.
</Warning>

Your watermark configuration is automatically included when you:

* 📄 Export to PDF
* 🖨️ Print documents
* 🔗 Share via public links

The watermark renders identically in all export formats, ensuring consistent document protection and branding.

## Advanced Techniques

### Layering Effect

Combine subtle branding with security:

1. **Base Layer**: Company logo at 5% opacity (repeated, grid)
2. **Security Layer**: "CONFIDENTIAL" at 12% opacity (repeated, diagonal)

<Tip>
  Currently VibeDoc supports one watermark at a time. For multiple watermarks, consider creating a composite image in an external editor.
</Tip>

### Dynamic Watermarks

For time-sensitive documents:

* Use date stamps in text watermarks
* Version numbers for draft tracking
* Status indicators (DRAFT, FINAL, APPROVED)

### Regional Variations

Adjust rotation and pattern based on language:

* **English/Western**: -45° diagonal works best
* **Arabic/Hebrew**: +45° diagonal for RTL reading
* **Asian Languages**: Consider grid pattern for vertical text

## Common Issues

<AccordionGroup>
  <Accordion title="Watermark too visible">
    **Solution**: Reduce opacity to 5-10%. Lower opacity maintains visibility while keeping focus on content.
  </Accordion>

  <Accordion title="Text appears blurry">
    **Solution**: Increase font size. Small text (below 24pt) can appear pixelated when rotated. Use 48pt or larger for rotated text.
  </Accordion>

  <Accordion title="Image looks pixelated">
    **Solution**: Upload a higher resolution image. Aim for at least 1000x1000px for repeated patterns.
  </Accordion>

  <Accordion title="Watermark not showing in PDF">
    **Solution**: Ensure "Print Background" is enabled in your browser settings. VibeDoc automatically includes watermarks in PDF exports.
  </Accordion>
</AccordionGroup>

## API Integration

<Info>
  Coming soon: API endpoints to programmatically set watermarks via document metadata.
</Info>

***

## Related Features

<CardGroup cols={2}>
  <Card title="Template System" icon="palette" href="/features/templates">
    Customize document appearance
  </Card>

  <Card title="Export Options" icon="file-export" href="/features/export">
    Export with watermarks to PDF
  </Card>
</CardGroup>