How to create a Person Profile in dotCMS

Michelle Kryska -

Updated from an original article written by Heidi Macwan.

Learn how to create a Person Profile in dotCMS.

How to navigate from the Content dashboard in dotCMS and select for the Person Profile content type.
  1. Log into dotCMS.
  2. Select Content on the left side of the screen.
  3. Select Search to display the Content dashboard.

Create person profile_steps 2-3.png


Content Dashboard

  1. Select the circled plus sign (+) on the far right side of the screen.
  2. Select Add New Content
    Create person profile_steps 4-5.png

  3. Select Person on the menu.
    Create person profile_steps 6.png

Person: Content Tab

NOTE: It is highly recommended that you read the Hint Text that is noted in smaller text above most fields prior to filing in that particular field. The Hint Text provides information or guidelines on how to properly complete each field.

  1. Host - REQUIRED FIELD: Open the Host drop-down menu.
  2. Select the Plus Sign (+) to open the www.canr.msu.edu folder.
  3. Select the Folder of the site you where you want to save the Person profile.

Create person profile_steps 7-9.png

NOTE: If you forget to select the folder in the Host field, then when you attempt to publish the person profile you will receive an error stating that “You don't have the required permissions to save the asset. User has no Add Children Permissions on selected host.” This usually means you've forgotten to select your folder from the "Host/Folder" field at the top of the page (above Title). Follow the steps above and republish the person profile. It should publish properly this time.

  1. Title - REQUIRED FIELD: Enter the person’s first and last name as the Title of the person profile.
    NOTE: This title is for back-end searching only. This Title is not displayed on the person's page.
  1. URL Title - REQUIRED FIELD: URL Title will fill in automatically; however, you may change this if you prefer a shorter or different URL.
    Create person profile_steps 10-11.png

PHOTO FIELDS

There are three optional fields for images, which are labeled as:

(Step 12) Image,
(Step 13) 3:2 Horizontal Image, and
(Step 14) Square Image

For these optional image fields, you can upload the same image of the person. Each image would have a different crop uploaded for each field. If you choose to upload a main/primary image in the first field (step 12), then it is recommended that you also upload an image in the other two image fields to ensure a favorable crop display of your image. If you do not upload or select an image for step 13 or step 14, then dotCMS may auto-crop your main/primary image (photo uploaded in step 12) to be displayed on a certain page or widget, which may or may not be a favorable crop.

Create person profile_steps 12-14.png

  1. Image – OPTIONAL BUT RECOMMENDED FIELD:  The main IMAGE field is where you can upload the primary photo for the person profile using the Browse button (step 12.A). This image is displayed on the person’s profile, Person Listing widgets (directories), and in search engines.

    To upload a new photo or to select an existing photo:
    12-A.  Select the Browse button for the Image field.
    Create person profile_steps 12-12A.png

    12-B.  From the Select a file window, navigate to the Uploads/Images folder on your site.
    12-C.  Either select an image that was previously uploaded to the Images folder, or select the Upload New File button to upload a new image from your computer.
    Create person profile_steps 12B-12C.png

    12-D.  If you selected Upload New File, then click on the Select File(s) to Upload button.
    Create person profile_steps 12D.png

    12-E.  Navigate to where the image file resides on your computer, choose the file, and then select Open.

    TIP: Image should be a high-quality photo (.JPG or .PNG file formats preferred) where the person is featured prominently and ensure that you have permission to use the photo. Headshots and official portraits are preferred.
    Create person profile_steps 12E.png
    NOTE: If a photo is not uploaded, then a placeholder graphic will appear on the person’s profile and in Person Listing widgets (directories).

  2. 3:2 Horizontal Image – OPTIONAL FIELD: This image field is for a 3:2 (ratio 3 wide by 2 tall) horizontal-cropped image that is a resized custom crop of the primary photo for use in widgets and on social media. You will need to crop the image in a photo editing application of your choice prior to uploading it to this field. See steps 12.A-E for photo upload instructions.
    NOTE 1: You will still need to upload the original sized primary photo in the main IMAGE field in step 12.
    NOTE 2: If a custom crop photo is not uploaded in this field, then dotCMS will custom crop it for you, which may or may not a favorable outcome, so it is recommended that you crop your photo in advance.
    Create person profile_steps 13-14.png

  3. Square Image – OPTIONAL: This field is for a square image (ratio 1 wide by 1 tall) that is a resized custom crop of the primary photo for use on home page templates using the four-square images container in dotCMS, and on the person’s Profile page. See step 12.A-E for photo upload instructions.
    NOTE 1:     You will still need to upload the original sized primary photo in the main IMAGE field in step 12.
    NOTE 2: If a custom crop photo is not uploaded in this field, then dotCMS will custom crop it for you, which may or may not a favorable outcome, so it is recommended that you crop your photo in advance.

  4. First Name – REQUIRED FIELD:  Enter the person’s preferred First Name. This field is displayed on the person’s profile and Person Listing widgets (directories).
  5. Middle Name – OPTIONAL FIELD: Enter the person’s preferred Middle Name or middle initial with period(.). This field is displayed on the person’s profile and Person Listing widgets (directories).
  6. Last Name – REQUIRED FIELD: Enter the person’s preferred Last Name. This field is displayed on the person’s profile and Person Listing widgets (directories).
    Create person profile_steps 15-17.png

  7. Honorific Suffix - OPTIONAL FIELD: Enter the person’s Honorific Suffix (i.e., Sr., Jr.) and/or academic titles or certifications. Please use MSU style when using these titles. This field is displayed on the person’s profile and Person Listing widgets (directories).
    NOTE: Common degree-related suffixes include: M.A., M.S., M.B.A., Ph.D.

  8. Alternate Name – OPTIONAL FIELD: Enter any Alternate Name for the person, including common abbreviations, maiden names, nicknames, and misspellings separated by commas. This field is not displayed on a person's profile.
    NOTE: If someone searches using these alternatives, the person’s name will appear in the search result. Additionally, articles, events, or digital documents where the alternate name is input in the contact/author field will link back to their profile.
  9. Pronouns – OPTIONAL FIELD: Using the drop-down menu, select the pronouns provided by the person.
    Create person profile_steps 18-20.png

  10. Roles – OPTIONAL FIELD: To create a Role or to relate a role to a person’s profile, select the Relate button. The Role content type is helpful for people who serve multiple departments or have multiple job responsibilities. This allows a person’s multiple titles/roles to appear on their Person profile web page with their “primary” role/title appearing first. Each person can only have one primary role. The Role content type also allows a person’s role/title to display on separate person listing widgets (directories) on related websites, as appropriate.NOTE:  A Role needs to be created for every new Person profile. You can create a Role or relate a role to a Person only AFTER a Person profile is created and saved or published to dotCMS. If a Person’s profile does not exist yet in dotCMS, then you cannot create a Role for that Person until their Person profile is done.
    Create person profile_steps 21.png

  11. To relate a Role that has already been created for a person in dotCMS, select Relate from the drop-down menu.
    Create person profile_steps 22.png

  12. Select the Role that matches the person.
  13. Select the Relate button.
    Create person profile_steps 23-24.png

  14. Email – OPTIONAL: Enter the person’s primary work Email address. This field is displayed on the person’s profile and Person Listing widgets (directories).
  15. MSU NetID - OPTIONAL, BUT HIGHLY RECOMMENDED FIELD: Enter the person’s MSU NetID. This field is not displayed on the person’s profile.


    TIP:     Fill in this field to help prevent the creation of duplicate person profiles.

    NOTE: If the person is not an MSU employee, then skip this field.

  16. Cell Phone – OPTIONAL FIELD: Enter the person’s Cell Phone number if they want it displayed on their profile.
    TIP:: XXX-XXX-XXXX

    Create person profile_steps 25-27.png

  17. Content – REQUIRED FIELD: Use the WYSIWYG Editor to enter and format the person’s Content.

    TIP: This may include content like their biography, work history, role(s) within their organization, academic publication history, etc.
    Create person profile_steps 28.png

 

Person Faculty Tab

  1. Select the Faculty Tab at the top of the screen. This tab allows you to input degree and CV details related to the person’s profile.
  2. CV - OPTIONAL FIELD: Upload a PDF of the person’s CV by selecting the Browse button, if applicable.

    Create person profile_steps 29-30.png

  3. If you selected the Browse button, then from the Select a file window, navigate to the Uploads/Files folder on your site.
  4. Either select a file that was previously uploaded to the Files folder or select the Upload New File button to upload a new file from your computer.

    Create person profile_steps 31-32.png

  5. If you selected Upload New File in Step 32, then click the Select File(s) to Upload button and navigate to where the file resides on your computer, and choose the file name and select Open.
    Create person profile_steps 33.png

  6. Select the Save/Publish button. By selecting Save/Publish for the file you are preparing it for publishing live with the person profile. It will not appear on the page until you Publish the Person profile.
    NOTE: DO NOT select the Save button. This will only save the file to the backend of the website as unpublished, and it will not appear live when you publish the person profile.
  7. Select Execute.

    Create person profile_steps 34-35.png

  8. Degree – OPTIONAL FIELD: Enter the person’s Degree(s), including degree type, concentration and college/university where they received their degree, as applicable.

    TIP 1: Ex. Bachelor of Science in construction management from Michigan State University.
    TIP 2: If the person has multiple degrees, then enter each degree on a separate line.
    Create person profile_steps 36.png


Profile Configuration Tab

  1. Select the Profile Configurations Tab at the top of the screen. This tab allows you to select which Related Content you choose to hide from a person's profile page, as needed. shows different content that can be related to a person’s profile.
  2. Select the check box next to the Related Content type that should be hidden from a person profile
    Create person profile_steps 37-38.png

 

Date Tab

  1. Select the Date Tab at the top of the screen. This tab allows you to select for a System Publish Date, a System Expiration Date and a Review On date.

    TIP: It is best not to use the System Publish or Expiration Date features. Instead you can create and Save Draft of the person profile to Publish live on the date you want the profile published, and Unpublish the profile as needed.

    NOTE: If you do use the fields in this tab, and you need to Unpublish the person profile, you will have to first remove the date/time information and Save Draft or Publish the profile. Then, you can select to Unpublish the Person profile.

  2. To select a Review On date, choose the dropdown menu. Once a date is selected dotCMS will remind you to review the profile on that particular date.

    TIP: It is recommended to review person profile content annually.

    Create person profile_steps 39-40.png

  3. Select the desired date, including month, day and year; and it will populate in this field.
    Create person profile_steps 41.png 

 

Relationships Tab

Fields associated with the Relationships tab moved to the to the Role content type. Relationships can be managed by opening a person’s related role.

 

Tags Tab

The Tags tab has moved to the Role content type. Tags can be managed by opening a person's related Role.

 

Final Steps - Publish Content or Save Draft

  1. The English language is the default for person profiles. You can skip this field.
  2. If you select the Save Draft button, it will save the person profile to the backend of dotCMS so you can still work on it before publishing it live.
  3. If you select the Check Links button, it will check the links in the person profile to make sure they work. If so, then the profile will be Published. If not, then an error message window will pop up letting you know which links need to be fixed.
  4. If you select the Publish button, it will Publish the person profile so it will appear live on the site.

    Create person profile_steps 42-45.png

 

Did you find this article useful?

You Might Also Be Interested In

Tag List
  • dotcms,
  • person content type,
  • profile folders,
  • web team
Michigan State University
  • Spartans Will.
  • © Michigan State University

MSU is an affirmative-action, equal-opportunity employer, committed to achieving excellence through a diverse workforce and inclusive culture that encourages all people to reach their full potential.

Michigan State University Extension programs and materials are open to all without regard to race, color, national origin, gender, gender identity, religion, age, height, weight, disability, political beliefs, sexual orientation, marital status, family status or veteran status. Issued in furtherance of MSU Extension work, acts of May 8 and June 30, 1914, in cooperation with the U.S. Department of Agriculture. Quentin Tyler, Director, MSU Extension, East Lansing, MI 48824. This information is for educational purposes only. Reference to commercial products or trade names does not imply endorsement by MSU Extension or bias against those not mentioned.

The 4-H Name and Emblem have special protections from Congress, protected by code 18 USC 707.

We comply with the Federal Trade Commission 1998 Children’s Online Privacy Protection Act (COPPA).