Template structure & Overriding templates via a theme

Overview

Ultimate Member template files contain your site's membership panel's markup and template structure for frontend and HTML emails.

Template files can be found within the ultimate-member/templates directory.

When you open template files, you will notice they contain hooks that allow you to add/move content without needing to edit template files themselves. This method protects against upgrade issues, as the template files can be left completely untouched.

Since version 2.6.2, we have implemented a template versioning feature to help you with updating outdated templates and sync when you update with our plugins, please see this article.

How to edit files

Edit files in an upgrade-safe way using overrides. Copy the template into a directory within your theme named /ultimate-member keeping the file structure according to the Templates Map. The copied file will override the Ultimate Member default template file. Edit the copied file to change a layout.

Example: To override the member directory base template, copy the file wp-content/plugins/ultimate-member/templates/members.php to wp-content/themes/{active_theme}/ultimate-member/templates/members.php where {active_theme} is your active theme folder.

Use an FTP connection to copy and edit files on the site. You can set up an FTP connection through the site control panel provided by the hosting provider. You will need an FTP client on your computer. We recommend using FileZilla Client.

Warning: Do not edit template files within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost. We recommend using a child-theme, which hasn't dependencies with the official themes repo, so your custom files cannot be rewritten after a theme upgrade.

Tip: You must maintain the folder structure of the template file when overriding the template via Theme/Child-theme.If your theme is wp-content/themes/twenty-fourteen/  and you need to override the member directory template /wp-content/plugins/ultimate-member/templates/members.php, the directory should be wp-content/themes/twenty-fourteen/ultimate-member/templates/members.php

Templates Map


MailChimp wp-content/themes/{active_theme}/ultimate-member/um-mailchimp/ account_email_newsletters.php
field.php
fieldset.php
fieldset_ch.php
form_subscribe.php
form_unsubscribe.php
Private Messages wp-content/themes/{active_theme}/ultimate-member/um-messaging/ email/new_message.php
email/new_message_reminder.php
account_notification.php
account_privacy.php
button.php
conversation.php
conversations.php
emoji.php
message.php
myCRED wp-content/themes/{active_theme}/ultimate-member/um-mycred/ account_points.php
badges.php
rank_bar.php
Notices wp-content/themes/{active_theme}/ultimate-member/um-notices/ notice.php
shortcode.php
Real-Time Notifications wp-content/themes/{active_theme}/ultimate-member/um-notifications/ account_webnotifications.php
feed.php
no-notifications.php
notifications.php
notifications-list.php
notifications_button.php
Online Users wp-content/themes/{active_theme}/ultimate-member/um-online/ nobody.php
online.php
online-marker.php
online-text.php
Profile Completeness wp-content/themes/{active_theme}/ultimate-member/um-profile-completeness/ completeness-bar.php
completeness-popup.php
widget.php
Google Recaptcha wp-content/themes/{active_theme}/ultimate-member/um-recaptcha/ captcha.php
captcha_v3.php
User Reviews wp-content/themes/{active_theme}/ultimate-member/um-reviews/ email/review_notice.php
member-rating.php
reply-add.php
reply-edit.php
reply-front-actions.php
reply-list.php
review-add.php
review-detail.php
review-edit.php
review-front-actions.php
review-list.php
review-my.php
review-none.php
review-overview.php
review-widget.php
Social Activity wp-content/themes/{active_theme}/ultimate-member/templates/activity/ new-follow.php
new-gform.php
new-gform-submission.php
new-group.php
new-post.php
new-product.php
new-topic.php
new-user.php
wp-content/themes/{active_theme}/ultimate-member/um-social-activity/ clone.php
comment.php
comment-reply.php
comments.php
edit-post.php
likes.php
new.php
trending.php
user-wall.php
Social Login wp-content/themes/{active_theme}/ultimate-member/um-social-login/ buttons.php
form.php
pre-loader-form.php
Stripe Account wp-content/themes/{active_theme}/ultimate-member/um-stripe/account/ billings.php
Stripe Checkout wp-content/themes/{active_theme}/ultimate-member/um-stripe/checkout/ order-details.php
 payment.php
Stripe Form Field wp-content/themes/{active_theme}/ultimate-member/um-stripe/ field-multiple.php
field-single.php
Terms & Conditions wp-content/themes/{active_theme}/ultimate-member/um-terms-conditions/ um-terms-conditions-public-display.php
Unsplash wp-content/themes/{active_theme}/ultimate-member/um-unsplash/ modal.php
photo_attribution.php
User Bookmarks wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/buttons/ add.php
remove.php
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/edit-folder/ form.php
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/folder-view/folder/ folder-info.php
title.php
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/folder-view/ add-folder.php
folder.php
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/single-folder/ bookmark-item.php
dropdown.php
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/ bookmarks.php
edit-folder.php
folder-view.php
single-folder.php
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/ modal.php
select-folder.php
User Locations wp-content/themes/{active_theme}/ultimate-member/um-user-locations/ infowindow.php
map-shortcode.php
map.php
User Photos wp-content/themes/{active_theme}/ultimate-member/um-user-photos/email/ new_album.php
wp-content/themes/{active_theme}/ultimate-member/um-user-photos/modal/ add-album.php
delete-album.php
delete-comment.php
edit-album.php
edit-comment.php
edit-image.php
likes.php
modal.php
wp-content/themes/{active_theme}/ultimate-member/um-user-photos/social-activity/ new-album.php
wp-content/themes/{active_theme}/ultimate-member/um-user-photos/ album-block.php
album-head.php
caption.php
comment.php
comment-form.php
comments.php
gallery.php
gallery-head.php
photos.php
single-album.php
User Tags wp-content/themes/{active_theme}/ultimate-member/um-user-tags/ tags.php
tags-widget.php
Verified Users wp-content/themes/{active_theme}/ultimate-member/um-verified-users/email/ verification_request.php
verified_account.php
wp-content/themes/{active_theme}/ultimate-member/um-verified-users/ account_info.php
profile_info.php
verified-account.php
Woocommerce wp-content/themes/{active_theme}/ultimate-member/um-woocommerce/ my-purchases.php
order-popup.php
orders.php
product-reviews.php
subscription.php