Quickstart guide

Signatures in minutes

πŸ”—Step 1: Download

Download and unzip the archive to a local folder: Download software DownloadsOpen issues

πŸ”—Step 2: One-time Preparations

πŸ’»

Client and User

Log on with a test user on Windows with Classic Outlook and Word. Running this on your primary account will overwrite signatures named Formal or Informal unless you use simulation mode, which is described later.

Linux, macOS, and New Outlook require the Benefactor Circle add-on and Exchange Online hosting.

πŸ›‘οΈ

Endpoint Security (AppLocker, Defender, CrowdStrike…)

Trust software signed with ExplicIT Consulting's certificate - all included PS1 and DLL files are signed with this certificate.

If needed, allow execution and library loading from the TEMP folder.

☁️

Create Entra ID app for Exchange Online

Follow the instructions in .\config\default graph config.ps1 for manual setup or have a "Global Administrator" or "Application Administrator" run the provided PowerShell command.

powershell.exe -noexit -file "c:\test\sample code\Create-EntraApp.ps1" -AppType "Set-OutlookSignatures" -AppName "Set-OutlookSignatures"

For national or sovereign clouds, add the -CloudEnvironment parameter.

Check the required permissions in advance: You can find all the information you need about usage in the files themselves as well as in the chapter Security considerations.

πŸ”—Step 3: Run Set-OutlookSignatures

☁️

Exchange Online / Hybrid

powershell.exe -noexit -file "c:\test\Set-OutlookSignatures.ps1" -GraphOnly true -GraphClientId "<GraphClientId from Step 2>"

-GraphOnly true ensures on-prem AD is ignored. Add the -CloudEnvironment parameter if using a national or sovereign cloud.

If the script fails to run, right-click Set-OutlookSignatures.ps1 > Properties > check Unblock.

🏒

Exchange On-Prem

powershell.exe -noexit -file "c:\test\Set-OutlookSignatures.ps1"

If the script fails to run, right-click Set-OutlookSignatures.ps1 > Properties > check Unblock.

You now find three new signatures in Outlook, based on the integrated sample templates and the attributes of your own user:

  • Formal is ideal for new emails to external recipients.
  • Informal is great for replies and forwards and for internal emails.
  • Test all default replacement variables gives you an overview of the integrated placeholders and a glimpse of what is possible for images and banners, phone number and address formatting.
πŸ’‘

Pro-tip: Start risk-free with Simulation Mode

If you lack Classic Outlook or want a zero-impact trial of the software, use Simulation Mode: This mode creates the exact signatures for the simulated user as files on your disk, without modifying Outlook β€” the perfect way to verify your configuration without changing any system settings.

Just add the parameter -SimulateUser a@example.com -SimulateMailboxes a@example.com and see the results in your Documents\Outlook Signatures folder.

πŸ”—Customize

🎨

Deploy Your Own Templates

Ready to move beyond samples? Copy .\sample templates to a new folder and start editing. We recommend following our folder structure guide to make future updates a breeze.

Point the script to your new files using:

  • -SignatureTemplatePath "C:\Signatures\Templates"
  • -SignatureIniFile "C:\Signatures\Templates\_Signatures.ini"

Using HTML? Just add -UseHtmTemplates true.

πŸš€

Scale Your Rollout

Once your templates are ready, explore the Full Feature List, the Technical Details and the Parameter Docs to automate the deployment and tailor it to your organization.

⭐

Share your Success!

Did you build something great? Whether it's a visually stunning email signature, clever out-of-office replies, custom replacement variables, or a unique third-party integration β€” we want to see it.

We’re looking to feature:

  • Final templates or unique design layouts.
  • Creative Out-of-Office (OOF) reply examples.
  • Snippets of custom logic or integration scripts.
  • A brief testimonial about your experience with Set-OutlookSignatures or the Benefactor Circle add-on.

Optional: Include your name, role, company logo, or a photo to be featured in our community showcase!

Get in touch & inspire others!

The Benefactor Circle license funds the open-source mission, ensuring the core engine remains free and peer-reviewable for the global community.