Adding Salesforce tokens for images, videos, maps, and buttons
As you use our Salesforce integration, you might have a need to pull in unique images and other visuals to personalize your Qwilr Pages. You can set up tokens for these!
In this article:
For this article, we're assuming you've already set up the Salesforce integration and created a template.
What kinds of visuals can you work with?
Qwilr supports these kinds of visual tokens:
- Images (you'll need to have them hosted online)
- Videos (hosted on one of our supported services)
- Google Maps (you'll need the embed code for your map)
- You can also attach a token to Qwilr's clickable button, so it can link to different destinations in different pages.
You can use any or all of these in a Qwilr template, alongside your regular Salesforce tokens.
Note: Wherever you host your visuals, they need to be set as publicly available. Private content won't work with tokens.
Creating custom fields for visuals
In your Salesforce account, you'll need to set up one or more custom fields for each type of visual you'd like to use. These fields should be "Text Area Long" fields, and they should be configured for plain text.
After you set up your fields in Salesforce, please reach out to our team to refresh your Qwilr token list. After we've done that, you'll see a new token in your Qwilr token list for each of your custom fields.
The new field will also appear in your Salesforce record. Below, we've added the custom field to the Opportunity layout, right below the Qwilr widget.
You can paste the URL for your hosted visual into the custom field.
Adding an image placeholder to the Qwilr template
Next, you'll need to set up the spaces in your Qwilr template where these visuals will go. You'll add placeholders, and then attach the new tokens to them.
As an example, let's say that you want to include a product image in each Qwilr Page. You have a total of 5 images, which are all hosted online. You have a unique URL for each one. You need to have different clients see different images in their Qwilr Pages. So we'll add an image placeholder to our template.
Step 1. Open your template for editing. To add an image placeholder, click on the + symbol that appears on any blank line. Then choose Image from the menu.
This adds a new image placeholder to the template. You can drag its corners to resize it as needed.
Step 2. Click on the top edge of the placeholder to bring up its toolbar. Click the Add Token icon. That will bring up a list of your Salesforce tokens. Locate the custom field's token and click on it.
That's it! Your image placeholder is all set. Now you can paste the correct image URL into each Salesforce record.
When you create a new page from this template, it will pull in the image URL from your Salesforce record and display it in the page.
For video, maps, and buttons
The process is the same for the other kinds of content: add the placeholder to your template, and then attach a token to it.
All of the placeholders begin by clicking on the + symbol on any blank line, and then choosing the type of content you need from the menu.
Removing a token from a placeholder
You can remove the token from any placeholder in your template. To do this, open your template for editing in Qwilr.
Locate the placeholder and click along its top edge. Then click the icon to remove the token.
After you remove the token, you can add a different token, or add a visual to the placeholder manually, or delete the placeholder.