Writing Style

This writing style guide is intended for those who write customer-facing content for M-Files and other related products. It provides stylistic and grammatical guidelines as well as punctuation ground rules for writing clear and consistent user documentation. The style guide also includes specific guidelines for creating user interface texts. These guidelines should be followed by everyone concerned to ensure that all content is written in the same, clear, and concise manner.

Conciseness and Consistency

The configurations editor lets you create metadata card configuration rules and modify settings of external repository connectors, intelligence services, and other applications that have been installed to the vault. The configurations editor in M-Files Admin allows you to define configurations for the following features of the vault: vault settings, custom vault data, metadata card, federated authentication, intelligence services, external connectors, vault applications The configurations in the editor are hierarchical. You can select subsections of a configuration in the gray navigation area, and the scope of the configuration shown in the Configuration or the Advanced tab changes accordingly.
Electronic signing is not available because the necessary metadata definitions for creating signature objects have not been set. For more information, refer to the M Files user guide. Electronic signing will not be available because the required metadata definitions for creating signature objects have not been set. In order for automatic signature objects to be created in M-Files, aliases must be created for the new object type as well as for the required property definitions. The aliases are used for creating objects at the time of signing. If you are using M-Files Compliance Kit, these definitions should already be available. Otherwise, you should create the required metadata definitions in M-Files Admin in order to activate the separate signature objects.
You can add content to your favorites by right-clicking on an item and selecting Add to Favorites in the context menu, or by clicking the star icon on the option ribbon of the metadata card. You can add content to your favorites by right-clicking on an item and selecting Add to Favorites in the shortcut menu, or by clicking the star icon on the toolbar of the object properties pane.
This command adds the object to the Pinned tab. This command adds the object to the Pinboard.

Tone and Voice of User Interface Texts

This section applies to user interface texts only.

Sorry, but we couldn’t get you the most recent version. The most recent version is unavailable.
Please try again later. The operation can be attempted again at a later time.

Style Conventions

This section outlines the style conventions used for at M-Files.

Standard American English

All M-Files content must be written in Standard American English. The most significant difference between written Standard American English and, say, written British English is that certain words are spelled differently. Pay special attention to how you spell certain words.

The tables below list spelling differences of words and suffixes (word endings) between Standard American English and British English. Please note that the lists are not by any means exhaustive, but they cover some of the most common differences. Whenever you are unsure of how a word is spelled in Standard American English, consult a dictionary, such as the online dictionaries by Merriam-Webster or Macmillan.

Words with Specific Endings

-ize Utilize, Minimize -ise Utilise, Minimise
-ization Localization, Utilization -isation Localisation, Utilisation
-yze Analyze -yse Analyse
-or Color, Behavior -our Colour, Behaviour
-er Center, Caliber -re Centre, Calibre
-se License -ce Licence
-og Catalog -ogue Catalogue

Verb Inflection Differences

Canceling Cancelling
Signaling Signalling
Dialing Dialling
Learned Learnt
Spelled Spelt

Spelling Differences

Check box Tick box
Counterclockwise Anticlockwise
Zip code Postcode
Airplane Aeroplane
Fiscal year Financial year
Elevator Lift


Avoid large chunks of text. Too much text in the user interface looks scary and lowers the chance of the user actually reading it. In documentation, the maximum number of words in a sentence is:


Capitalization means writing a word with the first letter as an upper-case letter and the rest of the word in lower case. This section sets the ground rules for using capitalization in M-Files content.


Headings should use the so-called title case, in which the first letter of each major word in the heading is capitalized, including individual words in hyphenated word combinations (such as Client-Side Registry Settings). Articles (a/an/the), conjunctions, and prepositions with fewer than five letters are not capitalized unless they start the heading. Examples of conjunctions not to be capitalized are and, but, and if. Examples of prepositions not to be capitalized are at, to, for, and with.

In contrast to the title case is the sentence case, which is the standard way of capitalizing English sentences. In the sentence case, only the first letter of a sentence is capitalized and subsequent letters are in lowercase, with the exception of proper names and acronyms.

Here are some examples of the title case:

Using Federated Authentication with M-Files

Comparison Between Esperanto and Ido

A Handy Guide to Cycling Routes in Tampere

Proper Names

Proper names are nouns denoting unique entities. Proper names are always capitalized and are thus orthographically distinguished from other parts of speech in sentence case. Proper names include product names (such as M-Files), organization names (such as Microsoft), place names (such as Tampere), persons (such as Jacques Anquetil) or any other names of individual entities.


Acronyms are abbreviations formed from the initial letters or parts in a phrase or a word. Examples of acronyms include URL, laser, HDMI, tRNA, and PnP. Acronyms are written in all uppercase, mixed case or lowercase, but most commonly follow the all-uppercase capitalization scheme, in which every letter in the acronym is capitalized (such as in HDMI and URL).

Some acronyms use mixed-case capitalization, especially the ones that are derived from an existing acronym by affixing. tRNA, for instance, uses a mixed-case capitalization scheme, since it is formed by affixing “transfer” to the acronym RNA. PnP similarly uses mixed-case capitalization, since the letter “n” in the acronym stands for “and”, which is commonly written in lowercase even in title case.

If the sentence begins with an acronym that starts with a lowercase letter, do not capitalize the first letter.

Some commonly used acronyms have taken on an identity as regular words. Such acronyms are therefore written in all lowercase letter. Examples of such acronyms include laser and scuba.

Do not use apostrophes (‘) when forming plural forms of acronyms. For example, write URLs, not URL’s.

M-Files Desktop, Classic M-Files Web, and M-Files Admin

Use title case for the following elements:

Dialog uses title cases Tab uses title cases

Menu items uses title cases

Button labels uses title cases

Node names in a navigation hierarchy uses title cases

Use sentence case for the following elements:

Sentance cases are used for check box options Sentance cases are used for radio button options

Sentance cases are used for drop list icons

Sentance cases are used for group box labels

Sentance cases are used for value and settings labels

Sentance cases are used for dialog body text

M-Files Mobile for iOS

Use title case for message titles, button names, and menu items. Use sentence case for message content. When in doubt, use title case.

M-Files Manage, New M-Files Web, and All Other New User Interfaces (Desktop)

Use sentence case throughout the user interface.


This section provides ground rules for the proper use of punctuation. These guidelines consist of agreed-upon conventions of specific cases where variation in the use of punctuation may occur.


In addition to using colons (:) normally in any body text content, add a colon after the following elements:

Colons are used after following elements: Lables and various dialogs

Commas and Semicolons

Rules for using commas (,) and semicolons (;):

Question Marks

Place a question mark (?) at the end of any question. This also applies to the user interface.

Quotation Marks

Quotation marks are used for identifying named entities, such as object or command names, in text content. Always use double quotes (“) when quoting something. Use single quotes (‘) only if you need to use quotation marks inside double quotes.

Use double quotes to refer to user interface elements in cases where you are unable to italicize or bold the text referring to the element. Referring to user interface elements in headings, for example, can be one such case.

In the user interface, use both quotation marks and apostrophes sparingly. For example, referring to short command names does not usually require using quotation marks: Use the Refresh Now command to resynchronize the group members.


There are two types of dashes to be used in documentation:

You can create an en dash (–) by typing ALT+0150 on Windows or by typing a single hyphen between two words in Word with AutoFormat enabled. The en dash is commonly used for indicating a closed range of values. Follow these guidelines for using en dashes:

Use the hyphen (-) character in the following cases:

Exclamation Points

Avoid exclamation points (!).


Periods (.) are used at the end of complete sentences that are not questions or exclamations. Use a period at the end of a list item only if the item is a complete sentence or if it continues the list-introducing sentence fragment.

Periods in M-Files Desktop, M-Files Web, and M-Files Admin

Use periods after complete sentences that are not questions or exclamations and that do not represent any of the elements mentioned in the following list:

Periods used in dialogs and tab titles

Periods used in group box labels

Periods used in menu items

Periods used in button labels

Periods used in node names in a navigation hierarchy

Periods used in Check box and radio button options

Periods used in Drop-down list options

Periods used in Group box labels

Periods used in Value and setting labels

Periods in the M-Files Mobile Apps

Include a period only after body text in message boxes and alerts.

Include a period only after body text in message boxes and alerts


Do not include ellipsis (…) in user documentation even if the ellipsis is part of the user interface text.

Use ellipses to indicate that something is in progress or requires further user input:


Do not use a slash (/) as a substitute for the word or, that is, to indicate a choice between two or more alternatives. Use the word or instead.

By using the Change state function, you can also add comments to the object while you are changing the workflow, the workflow state, or both. By using the Change state function, you can also add comments to the object while you are changing the workflow and/or workflow state.


Avoid technical jargon and overly technical and abstract terms.

Sorry, but you can’t use this operation for value list based properties. The operation is not supported for lookups.
Update object permissions based on the changes to the named access control list “%s”. Propagate changes to the NACL “%s”.

Do not use deictic expressions like today, here, below, above, or on the left. Their context can change. However, when you refer to any commands, buttons, or other elements in the user interface, make sure that the user does not have to guess where to find them, either.

The table lists the correct terms to use in documentation. Please use these terms to keep the language in documentation consistent.

and &
and so on, and so forth etc.
before prior to
compare c.f.
database DB
do, complete perform
for example, for instance, such as e.g.
if, when in the event that
Note: N.B.
that is, meaning, in other words i.e.
therefore, thus ergo
to in order to
select tick
check box tick box, option check box
click click on
context menu contextual menu, shortcut menu, pop-up menu
deselect clear
dialog dialogue, window
field text box, text entry box
drop-down menu pull-down list, pull-down list
email e-mail
enter, write type, input
use utilize
select choose
value list based property lookup, lookup property
Windows notification area system tray, status area
The New User dialog is opened. The New User dialog appears. The New User dialog emerges.

: A dialog is most often defined as a small window prompting for user response, whereas a window is a broader concept, essentially covering the term dialog as well.

Referring to User Interface Elements

Use a bolded font when referring to any user interface elements, like buttons, links, and titles. If font bolding is not available, use double quotes.

When referring to non-interactable user interface elements, use a definite article followed by the name of the element and then the type of the element:

The New User dialog is opened.

When referring to interactable user interface elements, use just the name of the element:

Click OK once you are done.

Sometimes, for clarity, it can be necessary to add the user interface element as an icon as well. In these cases, add the icon in parentheses right after the name of the user interface element:

Click the Create (Create icon) button and then select Document… from the context menu.

If the icon is big, consider making the screenshot smaller.

Referring to Other Content

When you refer to content that is in the same documentation where you refer from, use the verb “see”. When you refer to external documentation, use the verb “refer”.

For more information, see Adding Users.

For more information, refer to Editing Content in the M-Files user guide.

Abbreviations and Acronyms

Spell out the complete term the first time an abbreviation or acronym appears in the body text of the document and mention the shortened form in parentheses right after the complete term. After you have introduced and spelled out the shortening, use the shortened form throughout the rest of the document.

Here is an example:

Organizations have traditionally relied on Virtual Private Network (VPN) technology to secure access to corporate resources (such as M-Files vaults) from outside the private network of the organization.

Together, the HTTPS encryption and the use of a pre-shared key as a second factor in authentication provide similar security as VPN but without the complexity and compatibility challenges of VPN.

Remember to include all acronyms in the glossary of the document.


This section provides guidelines for the form and structure of headings. The following rules apply to all types and levels of headings:

Heading Levels

Use first, second, and third level headings for structuring your document. Use a fourth level heading only if absolutely necessary. Do not use more than four heading levels.

Heading Structure for Task Procedures

Use the gerund (the –ing form that is used for forming verbal nouns from verbs) form of a verb as the subject in task headings, instead of the sentence-initial to-infinitive phrase or a bare infinitive. Below are examples of the correct and incorrect heading structure for task procedures. Instead of using the how to structure, use the –ing form in headings as well as in the document title.

Creating a Login Account To Create a Login Account
Importing Login Accounts How to Import Login Accounts
Deleting Objects Delete Objects


Lists are used in documentation to lay out sequential steps for a procedure or to group related pieces of information together.

The rules for lists are:

Parallel structures for list items
Noun phrases:
  • M-Files Setup
  • M-Files Desktop
  • M-Files Desktop Settings
  • M-Files Server
  • M-Files Admin
Inperative form:
  1. Open M-Files Admin.
  2. Highlight Login Accounts in the tree view.
  3. Click New Login Account... on the task pane.
Gerundial phrases:
  • Adding new licenses and removing existing licenses
  • Adding new user accounts and removing existing ones
  • Changing user details and license types
  • Downloading M-Files installers
Sentence fragment that begins with a verb:
Multi-level interaction between several document vaults enables you to:
  • Replicate data across several locations.
  • Archive data from an actively used vault to an archive vault.
  • Centralize data from several M-Files vaults to a single vault.

Procedures (Step Lists)

Use numbered lists for sequential procedure steps to indicate the order in which a task must be carried out. When writing step lists, follow these guidelines:


  1. Open M-Files Admin and go to a vault.

    a) Open M-Files Admin.

    b) In the left-side tree view, expand a connection to M-Files Server.

    c) In the left-side tree view, expand Document Vaults, and then expand a vault.


  1. Complete one of these steps:
    • Click New Login Account on the task pane


    • Select Action > New Login Account
  1. Click OK.

    Result: A warning dialog is opened to tell you that the operation cannot be undone.

  2. Click Yes to close the warning dialog and start the migration.


Grammar Rules

This section provides rules for the following linguistic elements:

Proper Names

Proper names are nouns denoting product names, organization names, place names, persons, and any other names of individual entities. They are written using the initial capital letter.

Even though proper names refer to unique entities, in some cases, it can be necessary to be more specific to make the reference to the name clearer. In these situations, pair the proper name with a superordinate grouping word, such as window or button, and with a definite article preceding the name:

Note that an entity denoted by a proper name may belong to more than one group. In such a case, just use the grouping word you need to refer to.

The HTTPS protocol

The HTTPS encryption

Write the proper name with initial capital and the grouping word with lowercase letters.

If the proper name is not followed by a grouping word (like in the M-Files software), do not use an article.

Correct: Everything in M-Files is organized by what it is instead of where it is stored.

Correct: Everything in the M-Files vaults is organized by what it is instead of where it is stored.

Incorrect: Everything in the M-Files is organized by what it is instead of where it is stored.

Do not use any special formatting for proper names, such as italics or bolding.

Genitive Case

Use an apostrophe with the letter “s” at the end of a singular noun or just an apostrophe at the end of a plural noun to denote possession for animate entities. For nouns representing inanimate entities, use the of genitive instead to denote possession. If the readability suffers, you can also denote possession with “s” for nouns representing inanimate entities. With singular animate nouns ending with “s”, also use the ‘s to denote possession.

Charles’s car Charles’ car
Previous versions of M-Files M-Files’s previous versions
Developers’ conference Developers’s conference

Active Voice vs. Passive Voice

Active voice is the basic sentence structure of the English language. It is used in a clause whose subject expresses the agent (the “doer”) of the main verb. In contrast to active voice is the passive voice, which is used in a clause whose subject is the recipient of the action that the clause expresses. Below is an example of both voices.

M-Files can also store customer and project data. M-Files can be deployed on-premises, in the cloud, or as a hybrid of both.

Use active voice whenever possible.

Switch to the passive voice only when the primary focus of the clause is not on the subject. In written English, focus is primarily expressed by placing the new, non-derivable, or contrastive information at the beginning of a sentence. By switching to the passive voice, you can start the sentence with the element that would be the object of the sentence in the active voice. You can also use the passive voice when the subject of the clause need not be expressed or it is not known.


Documentation is for the most part written in the present tense, or more precisely, the simple present. Note that while the present tense generally refers to actions taking place at the present time, it can also have a reference to the future, especially to an arranged future event. Indeed, the simple present tense can be used to refer to future events that are certain to happen. This is why it is a suitable tense to use in contexts such as expected results because it is seen as more assertive than the future tense.

Here is an example:

Click New Login Account on the task pane.

Correct: The New Login Account dialog is opened.

Incorrect: The New Login Account dialog will be opened.

In the example, the present tense form can be regarded as an assertion, while the future tense form is more like a prediction.

Use future or past tenses only if it is required by the context, and if so, use only the simple forms of the past and the present tense. Note, however, that the past and the future tense are more acceptable in relative clauses than in main clauses.

Here are some examples of acceptable uses of the past and the future tense:

By enabling this setting, any of the objects that were included in an earlier export set, but are not in the current one, will be deleted in the target vault upon import.

Thanks to Automatic Updates, your M-Files installation will always be up to date.

Modals are used to express for example ability, possibility, permission, or obligation. Modal verbs include can, could, may, might, should, and must. In technical documentation and user interface texts, use should only if something is optional. If something must be done, always use must.

Use can to tell what the user or the system is able to do. Avoid using may. You can use it to describe possibility, but do not use it to tell that the user has permission to do something. As a rule of thumb, do not use might.

Compound Modifiers

Modifiers are words that describe nouns. Modifiers in general can be used in two different syntactic positions:

Compound modifiers are adjectives that are made up of two or more attributive words. When a compound modifier is used as a premodifier, the individual words in the compound must be joined with a hyphen. When a compound modifier is used as a postmodifier, the hyphen is not necessary, unless the word is a permanent compound and listed in the dictionary with a hyphen.

Vault-specific applications The applications are vault specific.
A well-known process The process is well known.

Gender-Neutral Language

Avoid gender-specific pronouns when writing documentation. There are a number of techniques for using gender-neutral language. The list below provides alternative ways of writing in a gender-neutral manner the sentence “The user can enter his e-mail address and his full name in the personal information fields”:

First Versus Second Person

Avoid mixing the first person (I/me/my) with the second person (you/your). For users, it can be confusing to see both person formats in the same context. Generally, use the second person when asking questions, giving instructions, or describing things to the user.


Do you want to check it out so that you can edit it?

You can't use the same path multiple times.

In some cases, it can be necessary to use the first person to indicate the user’s ownership of content or actions:

Assigned to Me

Checked Out to Me


A contraction is a shortening of a word, word group, or syllable, created by omitting internal letters. Can’t, for example, is a contraction of cannot.

Do not use contractions in documentation. Always write the full form of the word or word group instead. One exception is of in the phrase o’clock, in which the contraction is mandatory in contemporary use.


Cardinal numbers (one, 2, III) are used for counting things, while ordinal numbers (first, 2nd, 3rd, IV) are used for putting things in a sequential order. The following sub-sections tells you how to use numbers in documentation.


The symbols used for numbers (such as 1, 2, and 3) are called numerals. The rules for using numerals are:


Numbers and Units of Measurement

Negative Numbers

Negative numbers are written with a minus sign (-) immediately before the first digit of the number:




Decimal Numbers and Digit Grouping

Use the period character (.) as a decimal separator. If a number has more than three digits, separate sequences of three digits with a comma, starting from the first digit preceding the decimal point or the last digit if the number does not have a decimal point. Do not sequence the fractional part to the right of the decimal point.

Here are some examples:





When referring to monetary amounts, use one of these formats:

Negative amounts can be generally indicated with the words losses and deficit in descriptive texts to avoid using the minus sign (-):

A deficit of €600,000.00

Losses of EUR 600,000.00

In other text types, for instance in tabular data, negative amounts are denoted by a leading minus sign (-). Prefer using the currency symbol in conjunction with the leading minus sign, and use the currency code with a negative amount only if it is absolutely necessary:

Preferred: -€600,000.00

Non-preferred: -EUR 600,000.00


When referring to dates, use these formats:

Reference Documents

You may want to see these sources for additional information.