Troubleshooting Guide
Solutions to common issues and frequently asked questions.
Written By Matt Sywulak
Last updated 4 days ago
Deployment Issues
Signatures aren't appearing in my emails
Diagnosis Steps:
Check if signatures are enabled:
Go to Settings → Email Signatures
Look at "Enable Signatures" section
Toggle should be ON
Fix: Toggle to ON and save
Check deployment mode:
If Required:
✅ Should work automatically for all usersSignatures appear automatically
Check email client sync (may take up to 30 minutes)
If Opt-In:
⚠️ Users must opt in firstCheck if user has opted in (may take up to 30 minutes after opting in)
Prompt user to enable in email settings
Monitor opt-in stats on signatures page
If Opt-Out:
⚠️ User may have opted outCheck if user opted out
User can re-enable in email settings
Monitor opt-out stats on signatures page
Check profile matching:
User might be in wrong profile
Profile might be disabled
INKY email signatures are applied only to outgoing emails that pass through INKY.
Signatures appear for some users but not others
Likely Cause: Profile configuration
Diagnosis:
Check which profile user matches:
Look at profile criteria (emails/groups)
Verify user is in expected group
Check profile order (first match wins)
Check directory sync:
Group membership may not be updated
Wait 1 hour for sync
Or trigger manual sync (contact admin)
Verify deployment stats:
Example stats: Required: 247 active users Opt-In: 143 users opted in Opt-Out: 12 users opted outCompare with expected user count
Identify who's missing
Solution:
See Profile Issues for profile-specific fixes
Signatures disappeared suddenly
Possible Causes:
Signatures were disabled:
Check "Enable Signatures" toggle
Someone may have turned it off
Fix: Re-enable and save
Profile was deleted:
Check if user's profile exists
Check default signature still exists
Fix: Recreate profile or update criteria
Deployment mode changed:
From Required → Opt-In/Opt-Out
Users need to re-enable
Fix: Change back to Required, or notify users
License expired:
Check entitlement status
Contact Inky Support
Fix: Renew license
Image Issues
Logo/images not showing in signatures
Diagnosis Steps:
Check if image is uploaded:
Go to Images
Logo Image or Footer Image section
Should show thumbnail/preview
Fix: Re-upload image if missing
Check file format:
✅ Supported: PNG, JPG, GIF ❌ Not supported: SVG, BMP, TIFFConvert to PNG or JPG
Re-upload
Check file size:
Maximum sizes: Logo: 1MB (recommended: under 100KB) Footer: 1MB (recommended: under 200KB) User Photo: 1MB (recommended: under 50KB)Compress image if too large
Use tools like TinyPNG, ImageOptim
Re-upload compressed version
Check "Include" toggles:
"Include Logo Image" must be ON
"Include on Replies/Forwards" if needed
Fix: Toggle to ON and save
Check email client settings:
Some clients block images by default
User must "Show images" in email
Test in different client (Gmail, Outlook)
Images show in preview but not in actual emails
Likely Cause: Email client blocking images
Solutions:
For End Users:
Click "Show images" in email
Add sender to safe senders list
Update email client settings to allow images
For Admins:
Use smaller, optimized images
Provide text fallback for image content
User photos not showing
Diagnosis:
Check if enabled:
Go to User Photo in the User Signature Settings section
"Use API for User Photos" must be ON
Fix: Toggle to ON and save
Check directory integration:
Verify users have photos in Azure AD/LDAP
Check API connection status
Fix: Contact admin to verify directory sync
Check photo format in directory:
Some formats may not be supported
Photos should be JPG/PNG
Fix: Update photos in directory
Expected Behavior:
If user has no photo: Photo section is hidden (not broken)
Signature still displays normally without photo
Layout Issues
Layout looks different than preview
Possible Causes:
Email client rendering differences:
Outlook renders differently than Gmail
Mobile clients may stack columns
Fix: Test in multiple clients, adjust layout
Font substitution:
Custom fonts may not be available
Email client uses fallback font
Fix: Use web-safe fonts (Arial, Georgia, etc.)
Max width exceeded:
Signature wider than email client window
Fix: Set max width to 600px or less (Styling & Formatting) section
Two-column issues on mobile:
Columns may stack on small screens
Fix: Design with mobile in mind, or use single column
Fields not appearing in layout
Diagnosis:
Check if field has data:
Some fields (Phone, Title) only show if user has data
Preview uses sample data
Real signature uses actual user data
Fix: Ensure users have data in directory
Check if field is hidden:
Go to User Field Configuration → Unused/Hidden User Fields
Hidden fields don't appear in library
Fix: Remove from hidden list
Preview shows placeholders instead of real data
This is normal!
Preview uses sample data to show signature structure:
Name → "John Smith" (placeholder)
Email → "user@example.com" (placeholder)
Phone → "(555) 123-4567" (placeholder)
Actual signatures use real user data from directory.
To preview with specific user:
Deploy to test profile with just your email
Preview looks different on mobile
This is expected behavior:
Mobile clients render differently
Two columns may stack
Images may resize
Solutions:
Design mobile-first (single column)
Test on actual mobile devices
Keep signature simple for mobile
Profile Issues
Profile not matching expected users
Diagnosis:
Check email criteria:
Verify email addresses are correct
Check for typos
Fix: Update email list in profile
Check group criteria:
Verify group ID is correct
Check group membership in Azure AD
Wait for directory sync (up to 1 hour)
Fix: Update group list, or wait for sync
Check profile order:
Profiles are evaluated top-to-bottom
First match wins
Higher profile may be matching instead
Fix: Reorder profiles (move up/down)
Profile override not working
Diagnosis:
Check lineage indicator:
🔵 Globe or Building = Inherited (not overridden) 🟢 Green Person = Overridden (custom value)Click Icon to create override
Click Icon to remove override
Verify correct profile selected:
Check badge: "Profile: [Name]"
Check alert: "You are editing [Name] profile"
Fix: Switch to correct profile in dropdown
Check changes are saved:
Override must be saved to take effect
Fix: Click Save after creating override
Can't delete profile
Possible Causes:
Profile is selected:
Can't delete currently selected profile
Fix: Switch to Default, then delete
System profile:
Default profile cannot be deleted
Only custom profiles can be deleted
FAQ
Q: How long does it take for signatures to appear?
A: Signatures can take up to 30 minutes to appear, regardless of whether they are rolled out using Required, Opt-In, or Opt-Out.
Required: 5-10 minutes (email client sync)
Opt-In: Immediately after user opts in
Opt-Out: 5-10 minutes, unless user opts out
Q: Can users customize their own signatures?
A: Depends on settings:
User signatures enabled: Users can add personal touches
User signatures disabled: Centrally managed only
Check User Signature Settings → Enable User Signatures
Q: If users can customize their own signatures, how can they ensure they are using up-to-date directory information?
A: Users can import current information from Microsoft 365 or Google Workspace. In the User Center, the user accesses the Email Signatures page, clicks Import New or Updated Data, and edits the imported information as needed.
Q: Can I have different signatures for new emails vs replies?
A: Yes! Use Verbose (new emails) and Minimal (replies) layouts:
Verbose: Detailed, full branding
Minimal: Condensed, essential info
Configure each independently
Q: How do I test signatures before rolling out?
A: Best practices:
Create test profile with just your email
Configure signature
Send test emails
Verify rendering in different clients
Delete test profile when satisfied
Q: Can I schedule signature changes?
A: Not directly. Workaround:
Create new profile with future criteria
Manually activate profile on desired date
Or use campaign profiles for time-limited changes
Q: What happens if a user leaves the company?
A: Signatures stop automatically:
Directory sync removes user
User no longer gets signature
Sent emails retain old signature
Q: Can I use GIFs or animated images?
A: Technically yes, but:
Many email clients block animations
May not render correctly
Increases file size significantly
Recommended: Static images only
Still Need Help?
Before Contacting Support
Gather this information:
Screenshot of issue
Browser and version (Chrome 120, Safari 17, etc.)
Steps to reproduce
Error messages (exact text)
What you've tried already
Contact Options
Inky Support:
Provide info gathered above
Include your team name and user details
Found a bug or issue not covered here? Report it to Inky Support (support@inky.com) with details and screenshots.
Was this helpful?
More in Email Signatures
OverviewGetting Started with Email SignaturesProfiles & Deployment StrategiesSignature Layout Builder GuideStill need help? Ask the team