Do you still have questions about Spotlights? We are here to help!
In this section, we will answer these questions:
- What is the ideal image size for Spotlights?
- Troubleshooting Spotlights
- What happens if a Spotlight is published?
- How to tell if a Spotlight has been published
- What happens if a Spotlight is unpublished?
- What happens if the user does not interact with the Spotlight at all?
- What happens when a user clicks ‘Show me later’?
- How many times can a user choose to ‘Show me later’ on a Spotlight?
- Can I control how often the Spotlight shows up for a user?
What is the ideal image size for Spotlights?
The optimal image size is 400px width by 240px height with an aspect ratio of 16:9. Max file size is 5MB.
The image's width is stretched/shrunk to fit 400px. If the stretched image height extends beyond 240px, it is centered and clipped.
Example of ideal image size:
Attempting to link to a Spek from a Spotlight, but no Spek found
Scenario: When creating a Spotlight and linking to a Spek, if the search for the Spek name shows the message ‘No Speks found’ (as shown below).
The reason is a Spekit Team in Audience does not have access to the Topic the Spek is created in.
For Example: Consider a Topic called ‘April 2021’. The Spekit Teams with access to the Topic are:
- Sales Team
- Sales Demo
- Spotlight Test
Note: Spekit Account Admins always have access to all Topics in Spekit
For the Audience, a total of four teams were selected. In the example, the New Test Team does not have access to the April 2021 Topic (the Spek is present). If you desire a particular Team to be able to view the Spek you're linking to, make sure that Team can access the Topic that the Spek is created in.
Once the Topic permissions for the Audience (Teams) are set, you can now search for the Spek to link the Spotlight to.
Why won’t my Spotlight appear?
Spotlights will not appear when the path in the ‘Appears’ section is incorrect or when the Spek being linked to is not accessible by everyone in the Audience.
The Audience consists of the Teams in Spekit who have permission to view content on different Topics.
- For Example: If a Spek is selected to be viewed in a Spotlight and a Team of users does not have access to the Topic the Spek is located in, the Spotlight will not appear.
- If you are targeting the core domain, such as https://na174.lightning.force.com, use the Path Contains field.
When the URL contains field is filled out, you will have a couple of pathing options:
- Path is
- Path contains
- Path does NOT contain
- Path is NOT exactly
- When - URL contains: https://companyname.lightning.force.com
- or - Path contains: /lightning/o/Opportunity/list
When adding the URL to be targeted, it will need to be divided into two parts:
- The core part of the URL -https://companyname.lightning.force.com
- The extended part of the URL tells what object page in Salesforce to route to - /lightning/o/Opportunity/list
The finished result of the URL targeting should resemble the screenshot below:
Note: Please remember that the Salesforce portion before the .com varies depending on what instance you're on and if your Salesforce org uses a custom domain.
The above routing will trigger the Spotlight to appear on the Opportunity list view page.
What happens when a Spotlight is published?
Once published, the Spotlight will show up based on the Audience and Targeting rules. The Spotlight may take up to 10 minutes to appear for all Viewers.
How to tell if a Spotlight has been published
Once you have published a Spotlight, you will receive a confirmation message on the bottom left of the screen:
“Your Spotlight is published and should be live for all users within 10 minutes.”
The Spotlight you created will now show the Published status. Click the X to close the Edit Spotlight screen. The Spotlight you created will appear when the selected conditions are met.
What happens if a Spotlight is unpublished?
Users who are actively viewing it at that moment in time can finish their session. The Viewer’s time spent, completed engagement, and show me later engagement will still be recorded. However, the show me later button will disabled.
All other users will no longer see the Spotlight once unpublished.
If I unpublish and republish, who sees the Spotlight?
By default, a republished Spotlight will be shown only to users who have NOT viewed AND engaged with that Spotlight before.
- If you made an error and want to issue a correction to the entire audience.
- Policy update - links to the same Spek
- New version announcement - links to the same Spek
Why was my Spotlight unpublished when I clicked edit?
To avoid accidental changes, you can't edit live Spotlights. You can republish once you've completed your changes.
What happens if the user does not interact with the Spotlight at all?
If the Viewer doesn't interact with the Spotlight, it will remain on the page if no action is taken. If the tab is closed, the next time the tab is opened, the Spotlight will appear.
Users can access snoozed or previously reviewed Spotlights directly from the notification center. As long as the Spotlight hasn’t expired, you’ll be able to bring up the Spotlight by clicking on the notification.
If the Spotlight has expired, you’ll still be able to see the old notification, but you won’t be able to open the Spotlight.
What happens when a user clicks ‘Show me later’?
The Spotlight will go away and be presented again in 24 hours to the user.
After 24 hours, the Spotlight will reappear daily until the expiration date is met or a user clicks on the blue action button. The user can also access the snoozed Spotlight in the Notification Center.
How many times can a user choose to ‘Show me later’ on a Spotlight?
A user can select ‘Show me later’ once a day until the expiration is met. If there is no expiration then it can be done an unlimited amount until they engage with the Spotlight. You can monitor this via the analytics dashboard.
Can I control how often the Spotlight shows up for a user?
No. Spotlights will show up once a day until the expiration date is met or a user clicks on the blue action button. Republishing a Spotlight will not trigger it for users who’ve already seen it.
Can’t find the information you’re looking for? Check out these topics:
- What is a Spotlight?
- Why should you use Spotlights?
- Where are Spotlights located?
- How to search for a Spotlight
- How to Filter Spotlights
- How to sort Spotlights
- How to create Spotlights in the Spekit Web App
- How to create Spotlights in the Spekit Chrome Extension
- What does the End Viewer experience look like?
- How to delete Spotlights
- What can I view on the Spotlights analytics dashboard?
- How to access Spotlight analytics
- What can you Filter the analytics by?