Sliick Photos: Complete User Guide

Sliick Photos brings a beautiful, modern image gallery experience directly to your Salesforce org. This guide provides comprehensive instructions on how to install, configure, and use the Sliick Photos components in your Salesforce environment.

Installation & Setup

1. Install the Package

First, install the package into your Salesforce environment using the AppExchange listing.

2. Assign Permissions

Users who need to view or edit photos must have the appropriate permissions:

1. Go to Setup > Users > Permission Sets
2. Find the Sliick Photo Access permission set
3. Click Manage Assignments > Add Assignment
4. Select the users who need access and click Assign

---

Components Overview

The package includes two main Lightning Web Components:

Sliick Profile Photo

The Profile Photo component is designed for Contact and Person Account record pages. It shows the “primary” profile photo for that person and allows uploading a new profile photo directly.

Sliick Photo Gallery

The Photo Gallery component can be placed on any record page, supporting both standard and custom objects. It displays all images attached to the record under Files, supports Carousel and Grid layouts, and includes the Photo Editor for modifying images.

---

Configuration Guide

Adding Components to a Record Page

1. Navigate to the record page (e.g., a Contact record) in Salesforce
2. Click the Setup gear icon and select Edit Page
3. In the Lightning App Builder sidebar, look for the Custom components section

Configuring ‘Sliick Profile Photo’

1. Drag the Sliick Profile Photo component onto the canvas (ideal for the sidebar or header)
2. Properties:
   • Circular Crop: Check this box to display the photo in a circle (perfect for avatars). Uncheck for a square/rectangular aspect ratio.

Configuring ‘Sliick Photo Gallery’

1. Drag the Sliick Photo Gallery component onto the canvas (ideal for the main tab area)

2. Properties:

   • Filter by Topic: (Optional) Enter a Content Workspace Topic to only show specific images. Leave blank to show all attached files.
   • Default display mode: Choose between ‘Carousel’ (slideshow) or ‘Grid’ (thumbnails).
   • Grid columns: Number of images per row in Grid mode (Default: 5).
   • Grid rows: Number of visible rows in Grid mode (Default: 3).
   • Max height: Maximum height of the component in pixels to prevent scrolling issues.

3. Click Save and Activate to make the changes visible to users.

Enabling Topics for Files (Optional)

If you plan to use the Filter by Topic feature in the Photo Gallery, ensure users can tag files:

1. Permissions: Users need the “Assign Topics” system permission to tag files. To create new topics that don’t exist yet, they also need “Create Topics”.
2. Availability: Topics are enabled natively for Salesforce Files and do not require separate activation in “Topics for Objects”.
3. Lightning Page: For easier access to tagging, you may need to add the standard “Topics” component to the File record page in the Lightning App Builder.

Tip: Using File Topics

If you use the Filter by Topic setting, you must assign that topic to your image files:

1. Navigate to the Files tab or open the file from the Related List
2. Click to open the file preview
3. Click the Details tab (or ‘Show Details’ icon)
4. In the Topics field, type the name of the topic (e.g., “Gallery”) and press Enter
5. Only files with this exact topic will appear in the gallery when the filter is active

---

User Guide: Profile Photo

The Profile Photo component provides a quick way to manage a user’s avatar.

Viewing the Photo

• The component automatically looks for the latest profile photo associated with the record
• If no photo exists, a default placeholder is shown

Uploading a New Photo

1. Click the Upload button (or camera icon) on the component
2. Select an image file from your computer (JPG/PNG)
3. The image will be uploaded and automatically set as the current profile photo for that record

Technical Details

• Storage: The photo is stored as a standard Salesforce File attached to the record
• Naming: The system automatically renames the file to “Profile Photo” to identify it
• Versioning: When you upload a new photo, the system automatically deletes the previous “Profile Photo” file to keep the record clean. Only the latest uploaded photo is kept.

---

User Guide: Photo Gallery & Editor

The Photo Gallery allows you to browse, manage, and edit images attached to a record.

Browsing Images

• Carousel Mode: Use the left/right arrows to browse through images one by one
• Grid Mode: View multiple thumbnails at once. Click a thumbnail to view the full-size image

Editing an Image (Photo Editor)

From the gallery, click the Edit (pencil) icon on any image to open the Photo Editor.

Editor Tools

1. Drawing

• Click the Draw tab
• Select a Color and Brush Size
• Draw freehand directly on the image

2. Text

• Click the Text tab
• Type your text in the input box
• Click Add Text
• Move: Drag the text to position it
• Delete: Hover over the text and click the red ‘X’ to remove it

3. Undo/Redo

• Use the arrow buttons at the bottom to undo mistakes or redo actions

4. Saving

• Click Save to update the image
• Note: This creates a new version of the existing file in Salesforce. The previous version is preserved in the file history.
• If the image is very large, the system may ask to compress it automatically for better performance.

---

Summary

Sliick Photos transforms how your team manages images in Salesforce with its intuitive Profile Photo and Photo Gallery components. With zero external dependencies and 100% native Salesforce integration, your data never leaves the platform while respecting all security and sharing settings.

Ready to get started? Install Sliick Photos from the AppExchange today!