# Add-ImageText

Adds text to an image at the provided coordinates and writes the updated image to disk.

Project

ImagePlayground

Automate image processing, codes, metadata, charts, topology, and visual stories from PowerShell.

[View on GitHub](https://github.com/EvotecIT/ImagePlayground) [Visit Website](#) [Releases](https://github.com/EvotecIT/ImagePlayground/releases) [Changelog](#) [Get package](https://www.powershellgallery.com/packages/ImagePlayground)

Stars **102**

Forks **7**

Open issues 

Total downloads **708,853**

Release **ImagePlayground-PowerShellModule.v3.2.7**

Language: C# Updated: 2026-11-18

Command 

**Module**

`ImagePlayground`

**Inputs**

`System.String`

Adds text to an image at the provided coordinates and writes the updated image to disk.

## Syntax

```
Add-ImageText
[-Color <Color>]
[-FilePath] <String>
[-FontFamily <String>]
[-FontSize <Single>]
[-OutlineColor <Color>]
[-OutlineWidth <Single>]
[-OutputPath] <String>
[-ShadowColor <Color>]
[-ShadowOffsetX <Single>]
[-ShadowOffsetY <Single>]
[-Text] <String>
[-X] <Single>
[-Y] <Single>
[<CommonParameters>]
```

[#](#method-add-imagetext-color-string-string-single-color-single-string-color-single-single-string-single-single)

Parameter set: `All Parameter Sets`

## Examples

### Add watermark text

```powershell
Add-ImageText -FilePath in.png -OutputPath out.png -Text "Sample" -X 10 -Y 10
```

### Draw text using ImageSharp

```powershell
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.ColorSpaces;
using var img = Image.Load("in.png");
img.AddText(10, 10, "Sample", Color.Black, 24);
img.Save("out.png");
```

## Parameters

**-Color Color optional**

Text color.

**-FilePath String requiredposition: 0pipeline: True (ByValue)**

Source image path.

**-FontFamily String optional**

Font family.

**-FontSize Single optional**

Font size.

**-OutlineColor Color optional**

Outline color.

**-OutlineWidth Single optional**

Outline width.

**-OutputPath String requiredposition: 1**

Destination image path.

**-ShadowColor Color optional**

Color of shadow.

**-ShadowOffsetX Single optional**

X offset for shadow.

**-ShadowOffsetY Single optional**

Y offset for shadow.

**-Text String requiredposition: 2**

Text to add.

**-X Single requiredposition: 3**

X coordinate.

**-Y Single requiredposition: 4**

Y coordinate.

## Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see [about_CommonParameters](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).

Evotec API Reference Copyright 2026 Evotec Services

<!-- PowerForge markdown artifact sha256:A7130659A07F32EF45464BEC17087541513713B2270A25EF08BB8AC690671F61 -->
