Domains/Accounts

Here's everything you need to know about the fields on your Domain/Account record.

Warning: Very few users should have access to the Domains/Accounts page. Those with access should use extreme caution when editing any values in a Domains/Accounts record. Some values should only be edited by ACS Technologies staff.

If it says "Do Not Edit", please heed the warning and contact Support if you feel a change is needed.

Details

Internal Server Name: Your MinistryPlatform server name. Do Not Edit.
External Server Name: Your MinistryPlatform server name. Do Not Edit.
Application Title: The name of your church or organization that displays on your Platform login page. For more details, see Customize Platform Branding.
PocketPlatform API Server Name: Your PocketPlatform server name. Do Not Edit.
Domain GUID: Your domain's unique identifier. Do Not Edit.
Company Contact: The Contact record for your church or organization.
Database Name: Your MinistryPlatform server name. Do Not Edit.
Time Zone: The primary time zone or "standard time" of the Domain that affects the default date and time in which data is stored. Do Not Edit.
Locale: The primary locale or "culture" of the Domain that affects the default formatting and storage of the date, time, and currency.
Enable User Time Zone: The default setting is Yes, allowing users to set their own Time Zone and Locale preferences upon prompt when they log in for the first time.
We do not recommend disabling the user time zone. Instead, if needed, SPoCs should mass assign users' time zone to NULL. Setting the Enable User Time Zone field to No will remove Time Zone indication from the date and time fields in the user interface, disable Time Zone drop-down lists on the Edit User record dialog, and disable the Time Zone/Locale prompt.
Base Uri: Your MinistryPlatform base Uniform Resource Identifier. Do Not Edit.
Default Country Code: The code assigned to phone numbers for the country where this domain is located. Used for SMS texting. The United States value is 1.
Contact Card Template: The fields and formatting for your Contact Card.
Contact Merge Fields: The merge fields are available in the Contact Fields drop-down list of the New Message Tool.
Global Filter Page: Allows the data grid to be filtered by one Congregation/Parish at a time. The only currently supported values are null (clear) and Congregations.
Announcements Feed URL: Feed URL for MinistryPlatform product alerts. Do Not Edit.

Details: Contact MP Support for Setup

Link Shortener URL: Link shortener service provided in Azure. Do Not Edit.
Link Shortener API Key: A unique key that provides access to the link shortener service. Do Not Edit.
Writing Assistant API Key: Used to access and enable the Writing Assistant service. Do Not Edit.
Writing Assistant Base Uri: Scheme, domain, and port used by the Writing Assistant service. Do Not Edit.

File Configuration

File Provider Settings: For Azure BLOB storage, this is the Shared Access Signature as generated from your Azure Container. For local file system, this is the storage root folder or file share.
File Provider: The file provider for this domain.

Integrations

Google Maps API Key: Facilitates mapping inside various features. Learn more about the Google Maps API Key.
Recaptcha Site Key: The Google ReCaptcha site key necessary to allow Authentication Via Code.
Recaptcha Secret Key: The Google ReCaptcha secret key necessary to all Authentication Via Code.
Melissa License Key: Melissa Data SmartMover license information required to leverage Address Validation and Notification of Change of Address. Learn more about Melissa Data SmartMover Address Validation.

Reporting Configuration

Reporting Server Address: The report server endpoint serving reports for this domain.
Reporting Server Domain: Optional server domain if you use pass-through credentials to access reports.
Reporting Server Username: Optional username if you use pass-through credentials to access reports.
Reporting Server Password: Optional password if you use pass-through credentials to access reports.
Reporting Server Timeout: Server timeout for return report results. The default value is 600.

Responsibilities Assigned

Address Change Task User: User responsible for reviewing change of address notifications. Leave blank if you do not want to use the Melissa Data SmartMover change of address notification feature.
Messaging Approval Process: When populated, the Send with Approval feature is enabled in the New Message Tool.

Security Configuration

Password Authentication Enabled: Set to Yes. Enables passwords to log in to MinistryPlatform. Do Not Edit.
Password Complexity Expression: The password complexity requirements for all users for all applications. Supports JSON formats. See Password Requirements.
Windows Authentication Enabled: If Yes, the Platform login page will include the Windows.
Max Login Attempts: Number of unsuccessful login attempts a user can make before being locked out of MinistryPlatform. Once this value is reached, the user will be locked out. A locked-out user can be unlocked by resetting their password, having a SPoC reset the password on their User record, or having a SPoC edit this value to be zero. Leave blank if no lockout is needed.
API Service Anonymous User: API User. Do Not Edit.
API Service Password: Your API password might need to be shared with third-party systems for integration. Do Not Edit.
OAuth Signing Certificate Thumbprint: The thumbprint for the SSL Certificate associated with this domain. This value must match the External Server Name.

SMS Configuration

Disable SMS for Account Management: You may be in a situation where you don't want MinistryPlatform to send any texts for account verification, password recovery, one-time code logins, and multi-factor authentication. To disable texting for account management (without affecting texts sent from the New Message Tool and other areas of the Platform), set this value to Yes.
SMS Server Username: Twilio Account SID. You can find this on your Twilio dashboard under Account Info or on your account under API Keys & Tokens.
SMS Server Password: Twilio Auth Token. You can find this on your Twilio dashboard under Account Info or on your account under API Keys & Tokens.
SMS Server Callback Secret: A generated GUID value. You can use a GUID Generator to generate a random value.
Message Curfew Start Time/End Time: You can set a curfew timeframe during which text messages cannot be sent. If you've ever scheduled a group text to go out at 4 AM instead of 4 PM, you know why this can be useful! For Message Curfew Start Time, enter the time in the Domain timezone after which text messages should not be sent or scheduled. For Message Curfew End Time, enter the time in the Domain timezone before which text messages should not be sent of scheduled.
Note: If a user tries to send or schedule a message during the curfew, they'll receive a warning. They can still send the message if needed. For example, the youth group is returning from a trip later than expected and parents need to be contacted outside of the standard messaging hours. Make sure you clear your cache in the About section so these settings can take effect.

SMTP Configuration

The values in this section affect Platform Messages, Process Emails, and View Notifications. Other email sub-systems are configured elsewhere such as database Notifications, Portal messages, and Widget emails. If you need to update your email settings, please contact Support. We will update and test each sub-system for you, working with your IT team to resolve any issues.

SMTP Server Name: The name of your SMTP server. Do Not Edit.
SMTP Server Port: The port of your SMTP server. Do Not Edit.
SMTP Server Username: The username for your SMTP server. Do Not Edit.
SMTP Server Password: The password for your SMTP server. Do Not Edit.
SMTP Server Callback Secret: A GUID value generated when configuring SendGrid.
SMTP Enable SSL: Yes or No depending on your SMTP server/provider and use of SSL/TLS. Do Not Edit.
Email Domain: Defines the sending email domain(s) for the Email Server. For example, if your email addresses are all in the form "joe@universalchurch.org", you would enter the domain "universalchurch.org" in this field. You can add one domain per line. Any email sent from a domain other than the one(s) defined here will use the Email Proxy From Address. If you do not want to use the proxy, leave this blank.
Email Proxy From Address: Defines the From email address to use when the sender is not on Email Domain. This allows other domains to send emails through your domain. This address will be used in the From field, and the actual sender will be sent as the reply to the address.

User Account Configuration

Create Account Message Template: The Message template to use for the New User Account Confirmation email sent when a user clicks Create Account on the Login screen. A default template is provided and can be modified. The token [Link] is required. For security, this link is only valid for 10 minutes.
Recover Account Message Template: The Message template to use for the Password Recovery Verification email sent when a user clicks Forgot Password on the Login screen. A default template is provided and can be modified. The token [Link] must be included in the Message body to allow resets. Optionally, the token [Login_Link] may also be included to allow a one-time login without a password reset. For security, these links are only valid for 10 minutes.
Enable Simple Sign On: When enabled, a mobile phone or email address would be valid in place of a username during login.

Note: We strongly recommend enabling Simple Sign-On to help your users get into the Platform efficiently.
Custom Button URL: From the OAuth User Account dialog, the URL will be navigated to if the button is clicked. If blank, the button is hidden. Do Not Edit.
MFA Verification Email Template: The Message template to use for the Multi-Factor Authentication email.
MFA Required: Determines whether multi-factor is required for some or all users.
MFA Remember Days: The length of time between multi-factor authentications.
MFA Verification Text Template: The Message template to use for the Multi-Factor Authentication text message.
Create Account Text Template: The Message template to use for the New User Account Confirmation text message sent when a user clicks Create Account on the Login screen. A default template is provided and can be modified. The token [Link] is required.

Important: You can modify this template, but the [Link] token resolves to 32 characters, so be sure to factor that in when you write the text. You really only have 128 characters for that message. For security, this link is only valid for 10 minutes.
Recover Account Text Template: The Message template to use for the Password Recovery Verification text message sent when a user clicks Forgot Password on the Login screen. A default template is provided and can be modified. The token [Link] must be included in the Message body to allow resets. Optionally, the token [Login_Link] may also be included to allow a one-time login without a password reset.

Important: You can modify this template, but the tokens resolve to 32 characters each, so be sure to factor that in when you write the text. You really only have 96 characters for the rest of the message. For security, these links are only valid for 10 minutes.
Auth Code Enabled: Set to Yes to allow users to authenticate via code.
Auth Code Email Template: The Email Message template to use when a user opts to authenticate via code and receives an email with the code.
Auth Code Text Template: The Text message template to use when a user opts to authenticate via code and receives a text message with the code.

Files

For more on the Files panel of your Domain record, see Customize Platform Branding.

What would you like to know more about?