Configuring Employee Images

Employee Images is a Plus tier feature that allows you to display profile images directly in your org chart nodes. This enhances visual recognition and makes your charts more engaging and informative.

Overview

Employee images appear in org chart nodes alongside employee information. Images are fetched from publicly accessible URLs and displayed with customizable appearance settings including size, shape, layout, and borders. See Using Google Drive Images for a convenient way to manage images without hosting them separately.

Availability: Plus tier only. Trial users have full access during the trial period.

Setting Up Employee Images

Step 1: Prepare Your Data

To use employee images, you need a column in your Google Sheets that contains image URLs. Each URL should point to a publicly accessible image file.

URL Requirements

  • Protocol: HTTPS only (secure URLs)
  • Accessibility: The URL must be publicly accessible without authentication
  • Format: Common image formats are supported (JPG, PNG, WebP, GIF)
  • Size: Images should be reasonably sized (recommended: under 5MB)

Example Data Structure

Employee Name | Employee ID | Manager | Image URL
John Smith    | EMP001      | MGR001  | https://example.com/images/john.jpg
Jane Doe      | EMP002      | MGR001  | https://example.com/images/jane.png

Step 2: Map the Image Column

In the Project Setup page, locate the “Employee Images” field in the Mapping Card section.

Select the column from your Google Sheets that contains the image URLs. You can leave this unmapped if you don’t want to use employee images.

Note: Employee image mapping is only available if your account has the Plus tier.

Step 3: Configure Image Display

Once you’ve mapped the employee images column, you can customize how images appear in your charts using the Appearance settings. See the Customization section below.

Customization

Configure how employee images appear in your org chart nodes from the Appearance section in Project Setup.

Size

Choose the display size for employee images:

  • Small: 64×64 pixels - Compact option suitable for large charts
  • Medium (default): 128×128 pixels - Balanced size for most use cases
  • Large: 192×192 pixels - Prominent display for emphasis

Shape

Choose how employee images are displayed:

  • Circle (default): Images are displayed as circles
  • Square: Images are displayed as squares with optional rounded corners

Note: When shape is set to “Circle”, the border radius is automatically set to 50% and cannot be customized.

Layout

Choose how images are positioned relative to employee information:

  • Left (default): Image appears to the left of employee name and additional fields
  • Top: Image appears above employee name and additional fields

Choose “Left” for a compact horizontal layout. Choose “Top” for a stacked layout that emphasizes the image.

Border

Customize the border around employee images:

  • Width: Border thickness in pixels (0 = no border)
  • Style: Border style - Solid, Dashed, Dotted, Double, or None
  • Color: Border color selector
  • Radius (Square shape only): Curved corner radius in pixels (0 = sharp corners)

Note: Border radius customization only applies when shape is set to “Square”. For circles, the border radius is fixed at 50%.

Preview

Use the Preview section to see how your employee images will appear with your chosen settings. The preview updates in real-time as you adjust customization options.

Image Validation and Error Handling

OrgNice validates image URLs and handles failures gracefully.

Validation Process

Images are validated at the following stages:

  1. URL Validation: The URL must be publicly accessible via HTTPS
  2. Content Validation: The file must be a valid image format
  3. Image Validation: The image is normalized to the selected size and shape

Supported Image Formats

  • JPEG / JPG
  • PNG
  • WebP
  • GIF

Error Handling

If an image fails to load:

  • A placeholder icon is displayed in place of the image
  • The chart continues to render normally
  • A tooltip appears on hover showing the error reason
  • Validation errors are listed in the Validation section during setup

Common Error Reasons

  • URL Not Found (404): The image URL no longer exists or is incorrect
  • Access Denied (403): The URL requires authentication or has restricted access
  • Invalid Image: The file is not a valid image format
  • Connection Failed: The server is unreachable or offline

Troubleshooting

If images aren’t displaying:

  1. Verify URLs are correct - Check that image URLs in your Google Sheets are spelled correctly
  2. Ensure URLs are public - Test the URL in a new browser tab without logging in
  3. Check image format - Ensure files are in a supported format (JPG, PNG, WebP, GIF)
  4. Look for validation errors - Check the Validation section in Setup for detailed error messages
  5. Refresh your chart - Click the refresh button on the preview chart to reload images if they fail temporarily
  6. Re-map the column - Sometimes re-selecting the image column can help resolve temporary issues

Using Google Drive Images

You can use images stored in Google Drive by sharing them publicly. This is a convenient way to manage employee images without hosting them on a separate server.

How to Get a Public Google Drive Image URL

  1. Upload your image to Google Drive

    • Right-click the image file and select “Open with” → “Google Photos” or view it in Drive

  2. Share the file publicly

    • Right-click the image → Select “Share”
    • Change sharing permission to “Anyone with the link can view”
    • Copy the share link (format: https://drive.google.com/file/d/FILE_ID/view?usp=sharing)

  3. Extract the image URL

    • OrgNice automatically converts Google Drive share links to direct image URLs
    • Simply paste the share link directly into your Google Sheets image column
    • OrgNice will handle the conversion transparently

Example

Share link from Google Drive:

https://drive.google.com/file/d/1ABC123XYZ789/view?usp=sharing

Paste this directly into your Google Sheets, and OrgNice will fetch the image using the public sharing link.

Tip: Using Google Drive is convenient for small teams. For larger deployments, consider hosting images on your own server or CDN for better performance.

Coming Soon: Private Google Drive URLs with authentication support will be available in a future release, allowing you to use images from private folders within your organization’s Google Drive.

Exporting with Employee Images

When exporting your chart to different formats:

PNG and PDF Formats

  • Employee images are included in the export if they have successfully loaded
  • Images are normalized to the same size and format as displayed in the chart
  • Failed images (shown as placeholders) are not included in exports

SVG Format

  • Employee images are not included in SVG exports due to technical limitations of the format
  • Use PNG or PDF format if you need to export charts with employee profile images included

Examples

Example 1: Simple Profile Display

Setup: Image column mapped, Size=Medium, Shape=Circle, Layout=Left

Result: Circular profile images displayed to the left of employee names, suitable for most org charts.

Example 2: Prominent Employee Focus

Setup: Image column mapped, Size=Large, Shape=Circle, Layout=Top, Border=2px solid color

Result: Large circular images with colored borders displayed above employee information, emphasizing visual recognition.

Example 3: Professional Company Style

Setup: Image column mapped, Size=Medium, Shape=Square, Layout=Left, Border=1px solid gray, Radius=4px

Result: Square images with slight rounded corners, professional appearance matching corporate design standards.

Tips and Best Practices

  • Use consistent image dimensions: Square images (1:1 aspect ratio) work best
  • Test with a few rows first: Map a small set of rows and verify images display correctly before rolling out to the full chart
  • Use descriptive URLs: If possible, use image names that match employee IDs for easier maintenance
  • Backup URLs: Keep image URLs in a separate column for reference in case you need to update them
  • Monitor image availability: Periodically check that image URLs remain accessible
  • Resize images beforehand: While OrgNice handles sizing, pre-sized images (around 200-300px) load faster

Frequently Asked Questions

Q: Can I use images from Google Drive? A: Yes! See the Using Google Drive Images section for step-by-step instructions on how to share Google Drive images publicly and use them in your org charts.

Q: What happens if an image URL is broken? A: A placeholder icon is shown instead of the image. The chart continues to display normally. You can fix the URL in your Google Sheets and click the refresh button on the chart to reload the images.

Q: Are images stored on OrgNice servers? A: Only normalized cached copies are temporarily stored for performance. Original images remain at their source URLs. OrgNice does not retain images permanently.

Q: Can I use employee images in exported charts? A: Yes, if the images have successfully loaded in the chart, they will be included in PNG, SVG, and PDF exports.

Q: Why is this feature Plus tier only? A: Employee images require additional processing resources for normalization, caching, and serving. The Plus tier includes this feature along with other advanced capabilities like Export and Public Sharing.