Watermark JPG API

Watermark JPG image. Stamp a JPG with the text.

JPG

Add text watermark to JPG image easily with Watermark JPG API.

Copy parameter's URL Secret Secret
Type: String
Authentication secret must be provided as a query parameter. If omitted, token must be provided.
Show all
Copy parameter's URL Token Token
Type: String
Authentication token must be provided as a query parameter. If omitted, secret must be provided.
Show all
Copy parameter's URL File File Required
Type: File
File to be converted. Value can be URL or file content.
Show all
Copy parameter's URL StoreFile Store file
Type: Bool
Store converted file on our secure server and provides download URL.
Default: False Show all
Copy parameter's URL FileName File name
Type: String
Converted output file name without extension. The extension will be added automatically.
Show all
Copy parameter's URL Timeout Timeout
Type: Integer
Conversion timeout in seconds.
Default: 900 Range: 10 .. 1200 Show all
Copy parameter's URL Text Watermark text Required
Type: String

Specifies the text to use as watermark. The list of supported variables:

  • %PAGE% - current page number
  • %PAGES% - total number of pages
  • %FILENAME% - name of the file
  • %WEEKDAY% - full weekday name
  • %WEEKDAY_SHORT% - abbreviated weekday name
  • %MONTH% - month number (1-12)
  • %MONTHNAME% - full month name
  • %MONTHNAME_SHORT% - abbreviated month name
  • %YEAR% - year with century (YYYY)
  • %YEAR_SHORT% - year without century (YY)
  • %DAY% - day of month
  • %DAY_YEAR% - day of the year (1 -366)
  • %HOUR% - hour (01- 12)
  • %HOURS% - hour (00-23)
  • %MINUTES% - minutes (00-59)
  • %SECONDS% - seconds (00-59)
  • %AMPM% - AM PM
  • %DATE% - local date representation
  • %TIME% - local time representation
  • %DATETIME% - local date and time
  • %AUTHOR% - document Author
  • %TITLE% - document Title
  • %SUBJECT% - document Subject
  • %KEYWORDS% - document Keywords
Show all
Copy parameter's URL FontName Watermark font name
Type: Collection
Specifies the watermark font name. Contact us if you are looking for a specific font for a watermark that is missing from the list.
Default: Arial Values: Arial Bahnschrift Calibri Cambria Consolas Constantia Courier New Georgia Tahoma Times New Roman Verdana Show all
Copy parameter's URL FontSize Watermark font size
Type: Integer
Specifies the watermark font size.
Default: 40 Range: 1 .. 200 Show all
Copy parameter's URL FontColor Watermark font color
Type: String
Specifies the watermark font color.
Default: #ffffff Show all
Copy parameter's URL StrokeColor Stroke color
Type: String
Specifies font stroke color.
Default: #271851 Show all
Copy parameter's URL StrokeWidth Stroke width
Type: Integer
Specifies the stroke width.
Default: 1 Range: 0 .. 200 Show all
Copy parameter's URL FontEmbed Embed watermark font
Type: Bool
Specifies whether fonts should be embedded.
Default: True Show all
Copy parameter's URL FontSubset Font subset
Type: Bool
Specifies whether fonts should be subset.
Default: True Show all
Copy parameter's URL FontEncoding Font encoding
Type: String
Specifies the font encoding.
Show all
Copy parameter's URL TextRenderingMode Text rendering mode
Type: Collection
Specifies the text rendering mode.
Default: fillstroke Values: filltext stroketext fillstroke invisible Show all
Copy parameter's URL Rotate Rotate watermark
Type: Integer
Specifies the watermark rotation angle in degrees.
Default: 0 Range: 0 .. 360 Show all
Copy parameter's URL HorizontalAlignment Horizontal watermark alignment
Type: Collection
Specifies the horizontal watermark alignment.
Default: center Values: left center right Show all
Copy parameter's URL VerticalAlignment Vertical watermark alignment
Type: Collection
Specifies the vertical watermark alignment.
Default: center Values: top center bottom Show all
Copy parameter's URL PositionX Watermark X coordinate
Type: Integer
Specifies the watermark X coordinate. If set overrides property HorizontalAlignment.
Range: 1 .. 10000 Show all
Copy parameter's URL PositionY Watermark Y coordinate
Type: Integer
Specifies the watermark Y coordinate. If set overrides property VerticalAlignment.
Range: 1 .. 10000 Show all
Copy parameter's URL PositionUnit Watermark position unit
Type: Collection
Specifies measurement unit to use for the PositionX and PositionY properties.
Default: pt Values: pt in mm cm Show all
Copy parameter's URL Opacity Opacity level
Type: Integer
Specifies watermark opacity level.
Default: 100 Range: 0 .. 100 Show all

Code snippet

// Code snippet is using the ConvertAPI JavaScript Client: https://github.com/ConvertAPI/convertapi-js

// Code snippet is using the ConvertAPI Node.js Client: https://github.com/ConvertAPI/convertapi-nodejs

// Code snippet is using the ConvertAPI PHP Client: https://github.com/ConvertAPI/convertapi-php

// Code snippet is using the ConvertAPI Java Client: https://github.com/ConvertAPI/convertapi-java

// Code snippet is using the ConvertAPI C# Client: https://github.com/ConvertAPI/convertapi-dotnet

# Code snippet is using the ConvertAPI Ruby Client: https://github.com/ConvertAPI/convertapi-ruby

# Code snippet is using the ConvertAPI Python Client: https://github.com/ConvertAPI/convertapi-python

// Code snippet is using the ConvertAPI Go Client: https://github.com/ConvertAPI/convertapi-go

REM Code snippet is using the command line utility program: https://github.com/ConvertAPI/convertapi-cli

<!-- For conversions with the multiple file result please refer to this example: https://repl.it/@ConvertAPI/HTML-Form-with-multiple-file-result -->