Documentation

Installation

1. Download Paraph from the Mac App Store
2. Open Paraph from your Applications folder
3. You'll see the signature list on the left and the editor on the right

Creating Your First Signature

1. Click the + button in the sidebar to create a new signature
2. Give it a name (e.g., "Work" or "Personal")
3. Start typing in the editor, or click Templates to start from a design
4. Use the formatting toolbar to style your text
5. When ready, click Install to Mail to add it to Apple Mail

Paraph includes 15+ professionally designed templates covering minimal, corporate, creative, and structured layouts.

Applying a Template

1. Create a new signature or open an existing one
2. Click the Templates button in the toolbar
3. Browse the template gallery with live previews
4. Click a template to apply it

Applying a template replaces the current editor content. Your signature name and Mail.app assignments are preserved.

Customizing After Applying

After applying a template, everything is editable. Replace the placeholder text with your information, swap out images, change colors, and adjust the layout to match your brand.

The editor is a WYSIWYG (What You See Is What You Get) rich text editor. Changes appear in real time exactly as they'll look in your email.

Formatting Toolbar

The toolbar at the top of the editor provides quick access to formatting options:

Tool	Description
Bold / Italic / Underline	Basic text formatting
Font Size	Adjust text size (1-7 scale)
Font Color	Change text color with color picker or clear to remove
Line Height	Adjust spacing between lines (1.0 - 2.5)
Alignment	Left, center, or right align text
Link	Add or edit hyperlinks
Image	Insert images from file picker
Table	Insert and manage tables for structured layouts

Tables

Tables are the best way to create structured, multi-column signature layouts. Use Tab to move between cells. Right-click a table for options like adding/removing rows and columns.

Links

Select text and click the link button to add a hyperlink. You can link to websites, email addresses (mailto:), or phone numbers (tel:).

Add logos, headshots, or icons to your signature by dragging them into the editor or using the image button in the toolbar.

Supported Formats

• PNG (recommended for logos with transparency)
• JPEG (recommended for photos)
• GIF

Smart Image Sizing

Email signatures need to be compact. When you add an image that's too large, Paraph will evaluate it and present resize options:

• Acceptable — Image fits within size limits, no action needed
• Needs Review — Image is large; choose from suggested dimensions and quality levels
• Rejected — Image exceeds 1MB even at minimum quality; use a smaller source image

Resizing in the Editor

Click any image in the editor to see resize handles. Drag the corners to resize while maintaining aspect ratio. You can also click the image properties button to set exact pixel dimensions.

Paraph can install signatures directly into Apple Mail, complete with images. No copying and pasting HTML.

Installing a Signature

1. Design your signature in the editor
2. Click Install to Mail in the toolbar
3. Select which Mail accounts should use this signature
4. Click Install
5. Quit and reopen Apple Mail to see the changes

Updating a Signature

After editing a signature that's already installed, click Install to Mail again. Paraph will update the existing signature in Mail.app.

Removing a Signature

To remove a signature from Mail.app, open Mail's Preferences (Settings > Signatures), select the signature, and click the minus button.

Paraph uses Apple's CloudKit to sync your signatures across all your Macs signed into the same Apple ID.

What Syncs

• Signature content (HTML, name, images)
• Image attachments (headshots, logos)
• Social links and metadata

What Stays Local

• Mail.app assignments (which account uses which signature)
• Template data (bundled with the app)

Mail.app assignments stay local because each Mac may have different email accounts configured.

Besides installing directly into Mail.app, you can export your signature for use in other email clients.

Copy to Clipboard

Click the Copy HTML button to copy your signature as rich HTML to the clipboard. You can then paste it into the signature settings of Gmail, Outlook, or any email client that supports HTML signatures.

Signature doesn't appear in Mail.app

• Quit Apple Mail completely and reopen it
• Check Mail > Settings > Signatures to verify it was installed
• Try reinstalling the signature from Paraph

Images missing in received emails

• Verify the signature shows images in Mail.app's compose window
• Some recipients' email clients block images by default — this is normal
• Reinstall the signature to ensure images are properly embedded

Mail.app reverts to old signature

• Mail.app sometimes resets signatures after macOS updates
• Reinstall the signature from Paraph after each major macOS update
• Check that iCloud Mail signature sync is disabled in Mail preferences if it conflicts

Editor feels slow or unresponsive

• Very large images can slow the editor — resize them using the image size tool
• Extremely complex tables with many cells may cause brief delays