Brightspot CMS User Guide

Mail content mappings


Brightspot uses mail content mappings to transform an email submission to an actual item, such as to an article or an image. This section describes how to configure the fields in an article or an image so that editors can submit them over email.


To create a mail content mapping:

  1. Select Click menu > Admin > Sites & Settings.
  2. In the Sites widget, select the site to which you want emailed submissions to be published. The site you select will become the owner of article or images emailed to the site.
  3. Click search, and in the search field type Email to CMS.
  4. Under Mail Content Mappings, click add_circle_outline. A Mail Content Mapping form appears.

    Mail content mapping

  5. In the Receiving Email field, enter a “to” address to which editors submit content for a given content type.

    • For the username, as a best practice use the content type, such as article or image.
    • For the domain, use the Brightspot domain in your AWS SES (Simple Email Service) configuration.
    • Examples of “to” addresses are article@brightspot.example.com and image@brightspot.example.com.
    Caution
    If you are configuring mail content mappings for multiple sites, ensure that the receiving email addresses are unique across sites.

  6. Under Parsing Method, set Field Delimiter to the symbol for indicating a field name in an email. For example, if you enter #, then editors prefix the field names in their emails with an octothorpe.
  7. Under Content type, and using the following table as a reference, configure the converter to be used for an email sent to this address, and then set the field options. For some fields, you can select a markdown or simple processor to convert the field. If you configure a field to use a markdown processor, editors can include text formatting such as boldface and italics.
  8. To publish submitted articles immediately, turn on Publish Immediately.
  9. Click Save.

Options for article and image converters

Converter

Field

Description

Article Email Converter Headline Processor Set the type of processor for the field used as a headline, and specify the name of the field as found in the article content type.
Body Processor Set the type of processor for the field used for body text, and specify the name of the field as found in the article content type.
Section Processor Specify the name of the section field as found in the article content type. Editors can enter comma-separated values to associate the article with one or more sections.
Tags Processor Specify the name of the tags field as found in the article content type. Editors can enter comma-separated values to associate and articles with one or more tags.
Image Email Converter Caption Processor Set the type of processor for the field used for a caption, and specify the name of the field as found in the image content type.
Tags Processor Specify the name of the tags field as found in the image content type. Editors can enter comma-separated values to associate the image with one or more tags.
Previous Topic
Configuring an email ingestor
Next Topic
Submitting content via email
Was this topic helpful?
Thanks for your feedback.