Skip to main content

How to add names to Priority Message

ยท 5 min read
BuddyX

What if you could send a mass message to your fans but it appears like you have personally hand-typed that message for them? It goes to their piority tab and even has their name in it? Sounds too good to be true?

With template markers in the Priority Messaging tool, you can insert a fan's name into the message. This article will help you understand the purpose of these markers and how you can use them to target your fans better!

What are template markers?

Template markers are placeholders or variables that can take different values, like a name, in this case. Based on the marker chosen, these placeholders will be replaced with a piece of fan information when the extension is sending the messages to the fans. This makes a mass message more personal and has a higher likelihood of being opened.

How can you use the markers?

At the moment we support two different template markers. These markers are essentially the name with which you will message the fan.

  1. {displayName}: this is the custom name you have given to your fan. You set this name by clicking on the edit button next to the user name.
  2. {name}: the name that the fan has chosen to be displayed. This is specified by the fan in their profile settings.

And in case none of these names are specified, don't worry, you can have a default fallback like baby, honey or any word you wish and that will be sent to the fan.

When creating a Priority Message you can use template markers by using the "Insert Name" button. You can see all options in the dropdown with a short description of each one of them.

Template Marker cheat sheet

Please only use markers like this, no spaces in between brackets, separator and the marker:

A hieratchy - first check for custom name, otherwise take name by the fan. If both unavailable, take fallback word: {displayName|name|yourFallbackWord}

Only custom name, without a fallback: {displayName}

Only custom name, with a fallback: {displayName|yourFallbackWord}

Only fan defined name, without a fallback: {name}

Only fan defined name, with a fallback: {name|yourFallbackWord}

So let's get into details!

1. Custom Name:

When you want to use the custom name you have given each user to appear in the message, you have to use the marker: {displayName}. With this marker, the extension will replace the placeholder with the name everywhere you have used the marker. And for the fans you have not set a custom name, you can define a fallback value like this: {displayName|honey}. You can also leave it empty, in which case it will be empty!

Let's take an example message to explain it better!

Hi {displayName|honey}! How are you doing? I would love for you to come and lie next to me {displayName} ๐Ÿ’•

Result:

For a fan with a custom name, let's say Jack, the message sent will be:

  • Hi Jack! How are you doing? I would love for you to come and lie next to me Jack ๐Ÿ’•

For a fan with no custom name, the message will be:

  • Hi honey! How are you doing? I would love for you to come and lie next to me ๐Ÿ’•

2. Name chosen by the fan to be displayed

This is the name, which the fan has set for themselves on their profile page. Please keep in mind that not every user sets a display name in their profile page, or some keep names you would not want to address them with ๐Ÿคฃ. So be sure to check the names for fans you want to use this marker for! If there is no name defined by the user, the placeholder will be blank. Or if you want to define a fallback value, you can define it in the placeholder like this: (name|honey)

Let's take an example message to explain it better!

Hi {name|honey}! How are you doing? I would love for you to come and lie next to me {name} ๐Ÿ’•

Result:

For a fan with a display name, let's say Jack, the message sent will be:

  • Hi Jack! How are you doing? I would love for you to come and lie next to me Jack ๐Ÿ’•

For a fan with no display name, the message will be:

  • Hi honey! How are you doing? I would love for you to come and lie next to me ๐Ÿ’•

As mentioned in the cheat sheet, you can also specify a hierarchy, {displayName|name|fallback} or {name|displayName|fallback}. This will first look for the first marker specified, if unavailable it will check for the second, and if neither is available for a fan, it will take the fallback name specified by you.