Images in Storyboards & Image Management

Including images in a storyboard enhances storytelling, improves design, and creates a more visually engaging experience. Users can add images as backgrounds to certain tiles, aligning the visuals with their data insights.

Permissions

There are two permission levels;

1. Admin

Administrators with the Application Access Permission 'CanConfigureCompany' can upload images via Branding.

2. User

Users with the Application Access Permission 'CanCreateDashboard' and the Storyboard Permission 'Can View & Edit' can add images to Key Value Tiles or Free Text Tiles within a Storyboard.

Image Management

Uploading a New Image

1. Navigate to Admin > Branding > Image Management.
2. Click on the + 'Upload Image' icon in the toolbar.
3. Select the file to upload.
4. In the Upload Image pop-up:
   • Provide a Title for the image
   • Select the Image Type (JPEG or PNG) 
     • refer to "Understanding Imag eFile Formats (JPEG v PNG)"
   • For JPEG, Choose Quality (Low, Medium, or High)
5. Click Confirm to upload

Note: Any uploaded image undergoes an anti-virus scan to ensure security compliance.

Deleting an Image

1. Navigate to Admin > Branding > Image Management.
2. Click Delete on the row of the image you wish to remove.
3. A confirmation message will appear:
   "Are you sure you want to delete 'image' permanently? Deleting this image will remove it from any storyboard tiles where it is currently used as a background."
4. Click Continue to delete or Cancel to discard the action.

Using Images in a Storyboard

Adding an Image to an Individual Chart

1. Open your Storyboard.
2. Click on the pencil icon at the top right to enter Edit Mode.
3. Click on the + 'Build Storyboard' icon to add a Key Value Tile or Free Text Tile, or:
4. Hover over an existing Key Value Tile or Free Text Tile to reveal the tile menu.
5. Click on the Settings icon.
6. Navigate to the Design tab > Image Background section.
7. Find and select your image.
8. Choose an image size option:
   • Stretch: Expands the image to fill the entire tile.
   • Actual: Displays the image in its original dimensions.
   • Contain: Ensures the full image is visible without cropping.
   • Cover: Fills the tile while maintaining aspect ratio (cropping may occur).
9. Toggle Repeat Image On/Off (default: Off).
10. Click Update to Storyboard to save changes.

Notes

• Images can only be added to Key Value Tiles or Free Text Tiles.
• Once an image is deleted, it is removed from any tiles where it was used as a background.

Understanding Image File Formats (JPEG v PNG)

When uploading images, choosing the right file format is key to achieving your desired results. JPEG and PNG are designed for different purposes, especially regarding transparency and quality.

• JPEG (Joint Photographic Experts Group)

  • Main Purpose: This format is best for photographs, complex images with many colors, and web content where a small file size is a priority.

  • Transparency: JPEG files do not support transparency. If you upload a JPEG with a transparent background, the transparent pixels will be filled with a solid color, usually black.

  • Compression: Uses "lossy" compression, which permanently discards some image data to reduce file size. This is why you can select a Quality level (Low, Medium, High) to control the file size and quality trade-off.

• PNG (Portable Network Graphics)

  • Main Purpose: This format is best for logos, icons, graphics, screenshots, and images that require a transparent background or sharp, crisp lines.

  • Transparency: PNG files support an "alpha channel" to preserve transparency. This allows images to blend seamlessly with the background of your storyboards.

  • Compression: Uses "lossless" compression, which means the image retains its perfect quality no matter how many times it's saved. Because of this, the Quality option is not applicable and is removed for PNG files.

By understanding these differences, you can choose the right file format to ensure your images look and function exactly as you intend them to in your storyboards.