Here are some fairly common questions:
How do I get started?
How do I use images?
How do I upload a list?
How do I upload my own HTML source code?
How do I use CSS in my message?
How do I use personalization?
What is the difference between JangoMail and JangoSMTP?
How do I edit/change the CAN-SPAM footer?
How do I remove a bounced or unsubscribed address?
How do I send an SMS message?
How do I send a transactional message that uses conditional logic?
How do I use images?The best practice for using an image in your message/campaign is to provide a public path to the image as opposed to embedding the image. When you provide a source, or more precisely, a path, for your image, the only requirement is that the image is publicly accessible. In terms of HTML and the image tag (“img”), you should be able to take the URL value for the “src” attribute, paste the path into a browser, and see the image. For example, let’s say I want to include an image of part of the JangoMail home page in a message (and sized down a bit to fit within my message). The image by itself looks like this: The actual path to the image is: https://jangomailfaqs.com/wp-content/uploads/2020/10/homepage.jpg You can take that path, paste it into a browser, and see the same thing. The image within your message has to “live” somewhere, and you can host it with us for free within your JangoMail/JangoSMTP account. Go to Assets, click Add New Item, find your file, and upload it. Choose the file to upload: Start the upload: When the upload is finished: Now that your image (or images, you can certainly use more than one in your message) is uploaded and ready to be referenced in your message, insert the image via the HTML editor: In this popup window (Insert/edit image window), click in the “Image list” list of values field: Find and click on your image in the list, then click Insert to insert the image into your message: In the editor, you should be able to see your image: Click on the HTML menu button in the editor and you can see your source code in the popup window. Assuming you’ve made all other edits to your message, such as centering things, adding text, and so on, and you’ve sent the message, your recipients will see the image in their message via this part of the code behind your message: src=”https://img.jangomail.com/Clients/832833/Images/image_via_href_example.png” The delivered message using a linked source (i.e., not embedded) looks like this: The same message sent with an embedded image looks like this: Note that the image appears without having to click “Download pictures” in my Outlook client (Outlook being a good example of an email client that will automatically block images for you if you want). But also note that in reports, the spam score for what is essentially the same message is more than double the recommended way of including images: And for the message size comparison, the recommended approach versus embedding, the embedded version is more than 40 times larger, and that’s just based on using one image: To drive home this point, let’s say my message has 10 images in it, which is not out of the ordinary. Using the same image, the message size comparison becomes even greater: Bottom line: when using embedded images, you may have your message open with images showing right away, but the price you pay is having used much more data transfer, having a higher spam score, and running the risk of your message being marked as spam and not being delivered to a recipient’s inbox. Back to the top.
How do I upload a list?Here is a short example (including some tips) of using a file and list, plus we have a guide here. The first step is to create the list in your JangoMail account. Go to Lists and click Create New List. Name the list with some useful words. A list name of “Chicago Customers” is obviously much more understandable than “List X432.” With your list name, you can have more than word, just separate them by spaces. Assuming you want to include first name, last name, and last 4 of an account number fields, you’ll have to add the fields to your list (you get emailaddress by default). If you need to add more than one new field (your list has 10 columns, as an example), it is quicker to click the “Add New Field” icon 10 times (wait for each field to be added), and then go edit each one to rename NewField, NewField1, etc. to the names you want to use (for example, FirstName, LastName, Address1, and so on). I use a field naming convention of “init cap” for each word, and field names are only one word (no spaces in them, and the words are combined if need be). I would name a “first name” field as FirstName, “last name” as LastName, a company name as CompanyName, city as City, etc. As a tip, don’t upload columns you are not going to need or use in your campaign. If your original data file has 10 columns, but all you care about are the email address and first name columns, then save a copy of the file with just those two columns (no need to spend time creating fields in your list when you’re never going to be using them). Even better, when you save your file, put the email address in the first column. When a list is created in your JangoMail account, emailaddress is the first field by default. If your file’s column order matches your list’s field order, a lot of what follows next does not apply to you. In the example below, note that the order is: emailaddress, lastname, firstname, and last4. But, when I created my list in JangoMail, the order is emailaddress, firstname, lastname, and last4. The FirstName and LastName fields need to be switched in their position, either by fixing the Excel file (the csv file I’m going to upload) or by addressing the ordering of the fields when I start the upload in JangoMail. I’ll leave the file as is and adjust the ordering of the columns during the upload process. Start the process to upload your file. Select your list, click on the Edit icon, select the List Tools tab, then click Import Members. Since I am uploading a file, that’s what I click next. I’ll use the multiple fields option (uploading more than just email addresses), and click that option. On the next page showing the fields, you can drag a field from the left to the right, or click the Add All link to move all at once. If you drag one at a time, you can take care of the order then. If you click Add All, you can take care of the ordering as the next step. With all the fields now added for upload, all I have to do is arrange them in the order for what my list expects. In this case, I need to move LastName up above FirstName. The correct ordering is now displayed: The next step is to browse to the file and upload it. There is one little catch though – the first row of my csv file has column headers. That row will be treated as a record, but will be ignored during sending because the record does not contain a valid email address. You can live with this in your list, or just remove the row from your file and not have the clutter in your uploaded list. In this example, I’m going to delete the row and re-save my CSV file so my uploaded list is cleaner, so to speak. Quick detour – to save an Excel workbook as a CSV file, using Excel 2010 as an example – delete all sheets except for Sheet1, then go to File > Save As. Then, select the file format as CSV (MS-DOS): Browse to where the file is, and upload it. If your list is large, the count shown on the main Lists page may lag behind the count you see when you go into the list via editing. The main lists pages is refreshed about once a minute, so give it time to show your count. However, you can go into the list, and when the number shown there is what you expect to see, your list is ready for use in a campaign. Advanced feature (optional) You can also use our FTP feature to upload a list. Start an FTP client, logon with your username and password at ftp://client.jangomail.com, and place the file in the GroupImportsAutoFTP folder. The list will have the same name as the file, and the fields will be the same as the column headers in the file. Place the emailaddress column as the first column in the file. It can take a bit longer to upload a list if using the FTP method because all client FTP areas are continuously scanned for new files, and you will receive an email notification when the list import is complete (if you have notifications turned on in your account settings: Settings > Sending and Receiving > Notification Events). Back to the top.
How do I upload my own HTML source code?Let’s say you have an HTML template for your email message that was composed outside of JangoMail. What you are looking for now is a way to get that template into your JangoMail account. You have several options for this. First, what do you mean by template? Overall, any email message/campaign you send can be considered a template, so “template” can take on a couple of meanings. A template can be as simple as taking the last message you sent and copying that to start a new one, and you keep repeating that process over and over for subsequent campaigns. In this scenario, your template is the layout/formatting you used in the prior campaign. A template can also be as simple as “this is the HTML message I want to send for a particular campaign, and won’t ever send this message again.” In other words, a template can be the HTML source code for you current message, and you use the terms template and message interchangeably. Instead of copying the last message over and over, suppose you want to start with an older one and re-use it over and over. You could simply select that older message and copy it to start your new campaign. That older message then serves as your template. Every time you send, you would search for that older message among your messages, and once found, select it to start a new campaign. As a shortcut to searching for this older message, you can set a message property to have that message saved as a template (within your message, go to the Message Settings tab and switch the “Mark as template” option to Yes). For example, I have a new message to be marked as a template. Going into the Message Settings tab, I set the “Mark as template” option to Yes. When starting a new campaign, instead of searching for this older message in your list of past messages, you would now look for it in your saved templates (Messages > Compose New Message > with my Templates). If you are using our agency setup, where you have a master account and subaccounts, then a message marked as a template at the master account will be visible to your subaccounts. You can also use our FTP feature to upload a file (includes images, attachments, lists, and HTML files to be used as a template). If you upload an HTML file this way, then when starting a new message, you would select the “with an uploaded Template” option. Let’s take an example and start from scratch. Assuming you want to upload your template (the HTML source code) into a new message, start a new blank message, and in the editor you’re using, select the “HTML” menu button (TinyMCE editor) or the “Code” button (EditLive! editor). In the popup window that appears (or when you see actual code appearing if using the EditLive! editor), paste in your HTML code, and then click “Update” to exit the popup window (or click the “Design” button in EditLive!). Your rendered message will then appear in the editor. Here is my HTML source code created outside of JangoMail: In JangoMail, while composing a new message, go to the HTML source (or code if using the EditLive! editor, what is shown below is from the TinyMCE editor, which does not require a Jave Runtime Environment) and paste in your HTML source code: In the popup window, paste in your code and click Update: Back in JangoMail, you’ll see the rendered version of your HTML source code: If you want this message to marked as a template, then follow the steps mentioned earlier about marking the message as a template. ***Using FTP to upload images and files (Windows only approach)*** If using the user interface (i.e., you logon to your JangoMail or JangoSMTP account), images (and files used as attachments) can be uploaded via the Assets tab. Go to Assets > click Add New Item, browse for the file, and upload. If you have more than one image or file, you can also FTP your images, as an example, to your Images folder. You can use an FTP client such as FileZilla, or just use your Windows Explorer (not Internet Explorer; Windows Explorer is what you see/use when viewing My Computer, My Documents, or other folders within that interface). In the navigation/address field, enter ftp://client.jangomail.com, and when prompted, enter your JangoMail or JangoSMTP username and password. Once you are logged in, you’ll see an Images folder. Open it. Then, in another Explorer window, go to where your images are located on your PC. Select the ones you want to upload and drag them into the other Explorer window (they are not removed from your computer, just copied into the FTP folder). If you are uploading HTML templates, then the destination folder within your FTP area is the HTMLTemplates folder. If you are uploading attachments, then the destination folder is Attachments. Back to the top.
How do I use CSS in my message?CSS (cascading style sheets) is a great tool when building a web page. Unfortunately, email support for an inline style sheet (and some CSS elements) is not consistent, so the best way to use CSS – if you’re going to use it at all – is inline. Even then, “too much” CSS can scramble the layout of a message. It’s easy to see an example in Outlook: a message that looks and sends fine within Outlook 2003 can be not so good in 2007, and vice versa. You can see this when trying to wrap text around a picture, or relying on floating margins for placement of objects such as images. Outlook.com no longer supports the margin CSS property, including margin-top, margin-right, margin-bottom and margin-left. Float support has also been dropped. As an example, if your desired display of some formatted text is supposed to be this…
|This is text formatted using a style sheet|
How do I use personalization?To reference the first name in your message or subject, you enclose the field name with two per cent symbols. So, your subject can be: Special offer for %%firstname%% In the body of your message, you can use the field again (note you can use a comma or other text right after the closing %%): Hello %%firstname%%, Here is some information in our tutorials: List tutorial Personalization tutorial To extend the example a bit, using an address and a dealership, you could have a list with the address, first name, dealer name & phone, and dealer location. Your message body could be: