In-app message design with Visual Editor

With the Visual editor, you can drag-drop HTML components as visual components into the design panel and design the template according to your requirements.

The Visual editor provides a lot of advanced features to create a compelling template that you can use in your campaigns and send engaging messages to your customers.

You can also customize the height and width of the template as required.

The Visual Editor

The right panel in the Visual Editor has 3 tabs: Content, Rows, and Settings. This panel provides the components that you can drag-drop into the design panel to create the template.

The editor panel is where you design your template, add text and images, add personalization, and so on.

You can also use the toggle layouts option to view the template for various devices. 


The right panel in the template has 3 tabs that you can use to design the structure of the template.


Using the different types of rows, you can define the layout of your template. 

A single row defines the horizontal layout of that particular area of the template. You can add multiple rows to define the entire layout of the template. 

A row can include up to four columns, and it can either be empty or you can add content.


Drag and drop the various content components into the rows that you have added to the template. 

When you drag a content component into the required section of the template, it will auto-adjust to the column width. 

Whenever you select a content component, the properties for that element are displayed in the Content tab.


Specify the global style settings for the template. 

For example, you can specify the general width of the template, global font, background color, content alignment, and so on. 

Design the template structure

Design the structure or skeleton of your message by dragging rows into the design panel. Each row represents a horizontal area of your message template. Stack up rows to design the entire structure. Using a row with more than one column allows you to put different content elements side by side. 

For example, in the following image you can see 2 rows added to the template. The last row has 2 columns.


Add components

The Content tab has various components that you can drag and drop into the rows and columns that you have added to your template. After you add a component, when you select the component in the design panel, the properties for that component are displayed in the Content tab. Some components also have an editor toolbar that you can use to edit the component.

The following components are available for you to use in your templates.


Use the title component to add a heading in your template. 

You can have H1, H2, and H3 heading levels in the template.


Add the text component to add rich text to your template. 

When you work on the template, you can use the text editor toolbar to change the paragraph formatting. For example, you can choose a different font, insert bullet lists or URLs into the text, highlight the text, and so on.

​​Use the content properties in the Content tab to change font color, link color, line height, padding, and so on.

You can also use Liquid merge tags in the text content of the template. 


Add the image component to add images to your template. 

You can upload images from your computer, import images from a public location on the web (such as Dropbox, Google Drive, and more) or search for free images online. 

Use the content properties in the Content tab to edit the image, add a URL, apply effects, and so on. 


Add the button component if you want your customers to complete an action. A button in your template adds a call to action (CTA) to it. 

You can modify the button label, padding, border, radius, color, and so on.

For example, a button click can launch a web-page or an in-app page.


Add a divider component if you want a horizontal line break between the components of your template. 

The divider can be a solid, slashed, or dotted line, or a transparent spacer.


Add the social component to add social media icons that link to your social media profiles. 

Blueshift provides Facebook, Twitter, Instagram, and LinkedIn icons by default. 

You can add and remove social media icons based on your preference. You can add social media icons of your choice as well. You can provide links to your social media pages in the content tab as you work on the template. 


Add the HTML component to add custom HTML in your template. If you are comfortable with writing HTML, drop the HTML component in the template, select it in the design panel, and add your HTML code in the content tab. 


Add the video component to add a video in the email template. 

Note: You cannot upload a video to Blueshift but you can provide a URL for the video in the content tab. If you provide a YouTube or Vimeo URL, Blueshift can automatically generate a video preview. 


Add the icon component if you want to add icons in your template. 

Unlike the image component, you can add multiple icons in a single component and choose different icons for different purposes. 

For example, you can add your company logo and link it to your company's website and add a star icon that links to the reviews page of your website. 


Add the menu component if you want to provide menu items in your template. You can use this component to add clickable text components in your template. 

For example, you can add a menu at the top of the template that links to different pages of your site. 

For example, here is the same template in which we added 2 rows, but with components added to the rows.


The following example shows the component properties for an image component.


The following example shows the component properties and the editor toolbar for a text component.


Template settings

From the Settings tab, you can configure settings that apply to the entire message. These global settings are overridden by settings that you apply to individual components when you edit them.

Content area width

The width for the content area. 

This is set to 500px which provides enough space to design your message for mobile devices.

Content area alignment

Set the content as left aligned or center aligned.

Background color

This is the default background color for the message. 

You can override it at the row, column, and content block level by setting the properties for these components.

Content area background color

The default background color for the overall content area, which is the area for which you set the width above.

Default font

The default font family for all the content components. 

You can override it at the row, column, and content block level by setting the properties in the editor toolbar.

Link color

The default link color for all the links in the message.

You can override it at the row, column, and content block level by setting the properties for the component in the Content tab.


Responsive design for mobile devices

You can use various options to view and control how the template renders on various devices.

  • Use the toggle layouts option to view the template for desktops and mobile devices.
  • Set the “Do not stack on mobile option” so that the columns in a row are not stacked on mobile devices.
  • Set the “Reverse stack on mobile” option to control how the components of a row are stacked.
  • For images, set the “Full width on mobile” option to define the image size.
  • You can also select an individual component and set if the component is hidden on desktop or mobile devices.

The following example shows how a row with columns renders on various devices.


Comments for collaboration

When you select a component or a row, use the Show comments button to view comments that were previously added and to add your comments to the template. 

When you click on the Show comments button in the Content tab, all comments are displayed. You can add new comments or resolve existing comments. This can be useful in cases where your team is working on a template and would like to discuss their designs and decisions.


Edit history

Based on the edits that you make to the message template, the Blueshift platform provides an edit history. 

You can undo or redo your changes as you update the template. You can undo or redo up to 15 latest changes. To roll back your template to a point that's older than 15 last changes, click the history timeline button. The history timeline button provides changes that are older than the last 15 ones.

For each event in the timeline you can see the following information:

  • An icon to identify the type of content that was changed (such as an image or text).
  • A description of the change.
  • The time of the change.

When you select an edit in the timeline, the content or row that is tied to the edit is highlighted.

Note: This history is only available while you are editing the template. If you close the template and reopen it, the edit history is empty.


Define clicks and dismiss actions

You can use the blueshift://dismiss URL to define a custom dismiss action for an in-app message. A user click action to dismiss the message is tracked separately from other click actions.

The following default dismiss actions rendered by the SDK are also tracked as dismiss actions:

  • Clicking the default close button on modals, HTML, and Visual Editor Templates.
  • Swiping to dismiss slide-in banners.
  • Tapping outside to dismiss slide-in banners.
  • Clicking the back button to dismiss the message (for Android devices).
  • When URL = empty/NULL.

Note: If an action is not defined as a dismiss action, the user click for that action is tracked as a click in the Campaign Metrics.

Include Deep Links

Blueshift Deep Links are http or https URLs that take users to a particular page in the app or launch a particular page in a browser. When you send a Blueshift deep link in an SMS, email, or in-app message and a customer clicks the link, both iOS and Android can launch your app and open a particular page in the app that is mapped to the link.

For more information, see Deep Links for mobile apps.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.