The Plumbing Settings are used for the Add Plumbing Rough-Ins, Add Plumbing Connection Points, and Connect Rough-In tools. All Settings are saved to Revit project files when Revit is saved.
Each of the Settings tabs have been separated into their own user manual.
All of the sections start with Settings Files - Saving, Importing, and Exporting.
Table of Contents
- Getting Started Videos
- Settings Files - Saving, Importing, and Exporting
2.1- Managing your Settings file
2.1.1- Missing Settings Elements
2.2- Saving Settings to a Revit Project - Plumbing Settings
- Using the Add Plumbing Rough-In Tool
4.1- Plumbing Filtering - Rough-Ins & Connection Points
4.1.1- Filtering Schedules with Project Parameters
4.2- Rough-In Placement vs Connection Points Placement
4.3- Restore Default Rules
4.3.1- Default Rough-In Rules & 3D Rough-In Families
4.3.2- Default Connection Point Rules & Generic Annotation Families
4.4- Creating a New Rule
4.5- Configure Rule Conditions
4.6- Additional Conditions
4.7- Deleting a Condition
4.8- Deleting a Rule
4.9- Rearranging the Rule Hierarchy
4.10- Rough-In Placement
4.11- Placement Options
4.12- Selected Placement Location
4.13- Show Rotated Symbols When Sideways
4.14- Rule Combinations
4.15- Creating Plumbing Rough-In Families - Using the Add Plumbing Connection Points Tool
5.1- Selecting a Connection Point
5.2- Creating a Connection Point using the Generic Annotation Creator
5.3- Connector Conditions (Optional)
5.4- Connection Point Placement - Using the Connect Rough-Ins Tool
6.1- Selecting a Piping Linetype
1. Getting Started Video
2. Settings Files - Saving, Importing, and Exporting
To begin click on the Settings button.
On the left side of the window is your navigation menu, you can click on the vertical list of topics to open a specific Settings tab.
Each tab contains a subset of settings that are used by one of the many KitchDesigner ribbon tools.
The Settings button opens to the Project tab.
2.1- Managing your Settings file
At the top of the Settings window is the Settings Toolbar. This contains the Settings file name and (4) buttons to help you manage your Settings file.
There are occasions where changes in KitchDesigner Settings may need to be distributed to a team of users or you may just want save a backup, in these occasions you can use the Settings toolbar to export settings to other users that can then import them.
Export Settings files as JSON files and save them to your hard drive.
Import Settings files by selecting them using the file browser.
Settings files can also be renamed by clicking on the text to reveal a cursor.
2.1.1- Missing Settings Elements
Many of the settings are just links to Revit families and elements in your Revit project, if you import a Settings file into a Revit project that does not also contain these families then those links will be broken and you will receive a Error Message that explains which families were missing. You can copy this list to your clipboard using the Copy button.
2.2- Saving Settings to a Revit Project
A key feature of Settings is that when a Revit project is saved, the active Settings file is also saved to the Revit project file at the same time. This essentially binds the KitchDesigner settings to the Revit project file after each Save.
If the same Revit file is opened by another user on a different computer, all the settings will be just as they were when the Revit project was last saved.
In context of a Revit template file, once you have configured your company settings all you need to do is save your Revit template file and your Settings will also be saved. Any future user of this template will have their Settings pre-configured for their use without ever having to open Settings.
This works great for new projects but for all of your existing projects you will still need to use the Import and Export Settings buttons on the Settings toolbar.
3. Plumbing Settings
The Plumbing Settings are where you configure the Add Plumbing Rough-Ins, Add Plumbing Connection Points and Connect Rough-In tools.
4. Using the Add Plumbing Rough-Ins tool
Click on the Add Plumbing Rough-Ins button.
A prompt will appear letting you know how many new plumbing rough-in families were created and how many were skipped.
Rough-In families can be skipped for the following reasons:
- When the equipment families are missing the RI Height parameter specified in the rule (FCSI Shared Parameters).
- When using the MEP Filtering parameters for Plumbing on the Project tab. (See Plumbing Filtering below).
4.1- Plumbing Filtering - Rough-Ins & Connection Points
MEP Filtering Parameters is a KitchDesigner feature used to limit some of the families that can receive Electrical, Plumbing, or Mechanical Rough-Ins & Connection Points.
They are also used to limit the same families from appearing in Design Narratives.
To set up and access the built-in filtering, create a project parameter for your equipment families and specify this parameter in these MEP Filtering Parameters.
The KitchDesigner default parameter names are:
- Electrical - "Show in Electrical Schedule"
- Plumbing - "Show in Plumbing Schedule"
- Mechanical - "Show in Mechanical Schedule"
Here is how it works, add a Yes/No project parameter to your equipment families and place that same parameter in the KitchDesigner MEP Filtering Parameters.
Once you have the project parameter created, you can then uncheck this parameter for each family that you do not want to receive rough-ins or connection points from the Add Rough-In and Add Connection Point tools. For example, when the equipment is existing and not new, it doesn't need a new set of MEP rough-ins or MEP connection points.
4.1.1- Filtering Schedules with Project Parameters
You can also include these parameters in your schedules and use them to filter specific equipment out of your schedules.
Create a Filter in your schedule like this:
"Show in Plumbing Schedule" does not equal No
"Show in Plumbing Schedule" equals Yes is problematic due to the default state of the Yes/No project parameters in Revit which is null, not Yes. (grayed out Yes/No parameters evaluate to null).
To learn more about schedules and the MEP Filtering Parameters, check out our free tutorial Kitchautomation Tutorial 10 - Create MEP Schedules
4.2- Rough-In Placement vs Connection Points Placement
Each Rule contains a Rough-In Placement section and a Connection Points Placement section. You can toggle between them by clicking the R or C.
Rough-In Placement
Connection Point Placement
The Plumbing Settings consist of a rule based system for Rough-In and Connection Point placement. Users can create their own rules to place any family of their choosing.
Rules consist of:
- Each Rule can contain a Rough-In section, a Connection Point section, and a Piping linetype.
- Rules are created using logical operator Rule Conditions that use the Industry Shared Parameters
- Optional Connector Conditions can be used in conjunction with Pipe Connectors inside the equipment families
- Rough-In Height thresholds determine if a Floor, Wall, or Ceiling rough-in will be placed
- There are (6) different placement locations available for each rough-in and each connection point that can be specified per individual rough-in or connection point.
4.3- Restore Default Rules
KitchDesigner offers a full set of Default Rules for Rough-Ins or Connection Points that can be loaded into your project. These Default Rules also load the symbols that they place into your model.
First, click the Restore Default Rules button.
Next you will be prompted to select either Rough-In Rules or Connection Point Rules.
4.3.1- Default Rough-In Rules & 3D Rough-In Families
Select Rough-In Rules to load plumbing rough-in Rules into your Plumbing Settings.
These Rules include hot water, cold water, direct waste, indirect waste, and gas rough-ins.
Select Rough-In Rules under the Combination Rules section to also load the combination plumbing rough-in Rules into your Plumbing Settings.
These Combination Rules include Hot & Cold Water and Hot & Cold & Direct Waste.
Each Rule also loads 3D families for floor and wall rough-ins into your model.
These Rules use Hot Water Size, Hot Water RI Height, Cold Water Size, Cold Water RI Height, Direct Waste Size, Direct Waste RI Height, Indirect Waste Size, Gas Size, and Gas RI Height parameters.
All of the plumbing rough-in families that are loaded are Plumbing Fixture families.
The "C" & "H" symbols in the Hot Water and Cold Water symbols will be rotated when placed sideways to always stay upright using the Show Rotated Symbols when Sideways setting in Placement Options. (See 5.13)
4.3.2- Default Connection Point Rules & Generic Annotation Families
Select Connection Point Rules to load plumbing connection point Rules into your Plumbing Settings.
Each Rule also comes with a Generic Annotation family that will be loaded into your model.
These Rules use the Hot Water Size, Cold Water Size, Direct Waste Size, Indirect Waste Size and Gas Size parameters.
Connection Point Rules are split into (2) types, one Rule to handle Specialty Equipment families with Pipe Connectors and another Rule to handle Specialty Equipment families without Pipe Connectors.
4.4- Creating a New Rule
Click the 
in the bottom right corner of the Plumbing Settings group to create a new rule.
Give your rule a name by replacing "Rule Name" in the text box.
4.5- Configure Rule Conditions
First click a rule to select it to reveal the conditions. Selected rules have a teal outline.
The first step is to choose the RI Height threshold parameter for the Rule.
This is the parameter that will be used to determine whether a Floor, Wall, or Ceiling rough-in is placed.
Next configure your first condition using the dropdowns:
Select a Industry Shared Parameter from the first downdown.
Next select a logical operator from the second dropdown.
When a number-based Industry Shared Parameter is selected, the logical operators will resemble math operations.
When a text-based Industry Shared Parameter is selected, the logical operators can be used to match exact text or they can search text and evaluate based on what is contained.
Finally specify a value in the text box to be evaluated with your logical operator.
This condition is complete. This rule will now evaluate all equipment families and whenever an equipment family contains the Hot Water Size parameter with a value greater than 0, it will pass and move on to the placement section.
4.6- Additional Conditions
Each rule can contain as many conditions as you would like.
To add an additional condition, hover your mouse over the right end of your last condition to reveal an Add Condition button.
Click this to add another condition.
Configure your additional condition and repeat as necessary.
Options are endless and creativity is encouraged.
4.7- Deleting a Condition
Deleting a condition is similar to adding one, hover your mouse over the right end of the condition you want to delete to reveal a Delete Condition button.
Click the 
to delete the condition.
Conditions can only be deleted when a rule has more than one, otherwise the Delete Condition button will be inactive. 
If you create a condition that you must remove and it is the final condition of a rule, then you can create another condition as a workaround to activate the of the condition you want to delete.
4.8- Deleting a Rule
Select a rule by clicking it and then you can use the to delete it.
Selected rules have a teal outline.
4.9- Rearranging the Rule Hierarchy
Rules can be moved up and down
using the arrow buttons.
Rules are evaluated from the bottom up and each Specialty Equipment family can only receive (1) rough-in of the same type for each rule.
For example, it is possible to create (2) rules that place a "Hot Water Valve" family. If the rule that is evaluated first is successful for a particular equipment family, then that equipment family would not receive a 2nd "Hot Water Valve" family even if the 2nd rule also evaluated successfully. This means you could create a blanket rule such as Hot Water Size > 0 as a last line of defense if by happenstance your more specific rules are unsuccessful. This only works when the exact family type is set to be placed in both rules.
4.10- Rough-In Placement
Once the conditions are complete, specify the rough-in families to be placed.
Plumbing rough-in families can be from the following categories:
- Plumbing Fixtures
- Pipe Fittings
- Pipe Accessories
- Mechanical Equipment
Each rule can receive between (0) and (3) rough-in families to be placed.
To specify a Floor, Wall, or Ceiling family, click the to reveal the family selector dropdown.
Families cannot be face-based, floor-based, wall-based, or ceiling-based.
Specifying One Family
Specifying only one family to be placed regardless of which type will result is that family being placed regardless of the rough-in height. The rough-in height thresholds will not even be shown.
Specifying Two Families
Once you specify a second family, the rough-in height threshold will become active. The rough-in height threshold looks at the specified threshold parameter of the equipment family to determine which family will be placed.
In the above example, if the equipment RI threshold parameter is less than 6" then the Floor family will be placed. If the RI Height parameter is greater than or equal to 6" then the Wall family will be placed.
Specifying Three Families
Once you specify the third family, another rough-in height threshold will be active.
In the above example, the Floor family will be placed when the RI Height is less than 6", the Wall family will be placed when the RI Height is greater than or equal to 6" and less than or equal to 76", and the Ceiling family will be placed when the RI Height is greater than 76".
No Families
If you only want to place Connection Points, you can skip the Rough-In Placement section and move on to the Connection Point Placement section.
It is important to keep in mind that Conditions affect the entire rule, including both rough-ins and connection points. We will discuss this concept in detail below in the Connector Conditions section.
4.11- Placement Options
When using the Add MEP Rough-Ins or Add MEP Connection Points tools, you can control where each rough-in and connection point will be placed using the Placement Options.
Click the Show Placement Options toggle button to access the placement settings.
When the Show Placement Options button is active you can click it again to return to the family settings.
Show Placement Options changes all of the family dropdowns into placement indicator buttons.
Click on a button to open the Placement Settings for a particular rough-in.
There are three different Placement Settings windows:
One for Floor/Ceiling rough-ins:
Another for Wall rough-ins:
The Wall rough-in placement settings includes a wall image and a threshold dimension.
The THRESHOLD dimension determines whether wall rough-ins placed by this Rule are moved back to be flush with the wall behind the equipment. This field uses inches.
In the above example, if the back of the equipment is less than 30" from the wall then the rough-in will be moved directly back from the selected placement location flush with the face of the wall.
If the back of the equipment is over 30" from the wall then the rough-in will be placed in the selected placement location.
And a third for Connection Points:
4.12- Selected Placement Location
There are (6) possible placement locations. Each of these locations is represented by a checkbox.
When specifying the Wall rough-in placement, keep in mind that all placement locations will be moved to the face of a wall including the center-center placement.
The default placement location is the center-center of the equipment family.
The Show Placement Options icon also shows the selected placement location.
The placement options icons are also visible from the Settings. 
The other locations are back left.
Back center left
Back center
Back center right
Back right
4.13- Show Rotated Symbols When Sideways
For anybody that uses letters in their rough-in symbols, we have added a special feature to rotate the letter when the rough-in is placed sideways.
To use this feature, add a Yes/No visibility parameter to your rough-in family and specify that parameter in the Rotate When Sideways group of the Show Placement Options window.
Associate this parameter with a 90 degree rotated letter inside your rough-in family and when a rough-in is placed sideways, the Yes/No parameter will be checked by the Add Plumbing Rough-Ins tool.
The result is your letter symbols always sitting upright.
4.14- Rule Combinations
Rule Combinations are a special Rule that can replace two or more families with a single family when two or more rules pass for a single equipment family.
Let's take a look at the Rules above, one rule will place a Hot Water RI when Hot Water Size > 0. The other rule will place a Cold Water RI when Cold Water Size > 0.
Now take a look at the Rule Combination below.
This Rule Combination places a Double Pantry Faucet family whenever the Hot Water and Cold Water Rules pass. Those are the same rules from above.
Rule Combinations are a great way of reducing the amount of families that get placed when using the Add Plumbing Rough-In tool and result in only one tag getting placed for multiple rough-ins.
It is possible to add unlimited rules to a Rule Combination and they include Rough-In Height thresholds similar to the Rough-In Rules.
4.15- Creating Plumbing Rough-In Families
KitchDesigner requires Plumbing Fixture, Pipe Fittings, Pipe Accessories, or Mechanical Equipment families to be used with the Add Plumbing Rough-Ins tool. 3D rough-ins are not required but they are highly recommended. Kitchautomation provides a default set of 3D MEP families when you use the Restore Default Rules button.
If you decide to build the plumbing rough-in families on your own, please read the following tips:
- Adding the Item Number parameter to your Rough-In families is recommended if you use Item Number as your Mark parameter but it is not required. The value of the Item Number parameter is passed to the Rough-In family's Item Number parameter.
- Adding RI Height parameters to your Rough-In families is recommended but not required. The value of the RI Height parameters is passed to the Rough-In family.
- When locking the RI Height parameter to a dimension to control the geometry’s height, remove any reference planes in the Front elevation that are not snapped to the geometry. Offset & RI Height are set based on whether the reference planes in the Front elevation move with the 3D geometry.
- For your wall rough-in families, locate the insertion point in the center (L-R) and at the wall (F-B), the families insertion point will be moved back to the face of the wall so if you had a escutcheon you would set the insertion point at the back of the escutcheon.
- For floor or ceiling rough-in families, locate the insertion point in the center-center.
5. Using the Add Plumbing Connection Points Tool
Click on the Add Plumbing Connection Points button
A prompt will appear letting you know how many new plumbing connection points were created and how many were skipped.
Plumbing Connection Points can be skipped for the following reasons:
- When using the MEP Filtering parameters for Plumbing on the Project tab. (See Plumbing Filtering).
5.1- Selecting a Connection Point
Selecting a Connection Point to be placed by your Rule is done using the 
button.
Generic Annotation families can be selected from the dropdown list.
5.2- Creating a Connection Point using the Generic Annotation Creator
Select a Connection Point using the button.
Generic Annotation families can be selected from the dropdown list.
Select Create New... to create a Generic Annotation family to be used as a Connection Point by the Add Plumbing Connection Point tool.
Once you click Create New... the Generic Annotation Creator window will appear.
You can create your own Generic Annotation family using (3) different shapes, (3) different sizes, and your choice of (1), (2), or (3) letters in the inside of your shape.
- Small - Approx 4.25" at 1/4" scale and can contain up to (2) letters
- Medium - Approx 6" at 1/4" scale and can contain up to (3) letters
- Large - Approx 7.5" at 1/4" scale and can contain up to (3) letters
Make your selections and to see a preview of what your Generic Annotation will look like. (not to scale)
Specify the SubCategory Name, Color, and Thickness. Subcategories can be accessed from the Object Styles button on the Manage tab in Revit.
Give your new family a unique name and click 
to create a Generic Annotation family and add it to your project.
This newly created family will now be selectable as a Connection Point.
5.3- Connector Conditions (Optional)
It is important to understand that Connector Conditions are not required to place Connection Points. These special conditions are added on top of the Rule Conditions to add an extra layer of differentiation for families that contain connectors.
The benefit of using Connector Conditions is to differentiate families with different Pipe Connectors, allowing you to place one type of symbol for certain Pipe Connectors, and a different symbol for other types of Pipe Connectors.
If you just want to place Connection Points on every equipment family where Hot Water Size > 0, then you can just leave the Connector Conditions empty and they will act as if they pass for every family. The Add Plumb Conn tool would then move on to placement and place the specified Plumbing Connection Point per the Placement Options.
But it is also possible to leave the Rule Conditions on the RI side empty and use only the Connector Conditions for your rule. Here is a quick refresher on Connectors so you see what parameters can be used in conditions.
Connector Labels
Although Connectors are inside of families, it is possible to see them from a floor plan view in your project. By clicking on a family to select it you will be able to see the connectors inside of that family.
They don't give you much information about the connector but the labels do show a symbol that can be used to figure out the System Classification.
Here is a handy guide to all of the connector labels:
Pipe Connectors
Pipe Connectors can be added to any family using the Pipe Connector button on the Create ribbon. They just need to be attached to an extrusion or other piece of geometry.
By clicking on the Pipe Connector Element represented by the green circle you are able to see the Connector properties.
Two properties are used by Connector Conditions:
- Connector System Classification is a dropdown list that cannot be edited
- Connector Description is a text field that can be edited.
Now let's click to select a rule and reveal the conditions. Selected rules have a teal outline.
Next configure your first Connector Condition using the dropdowns:
Select either Connector System Classification or Connection Description from the first downdown.
When Connector System Classification is selected, the logical operators only include equals and does not equal.
The last step is to specify a Connector System Classification from the dropdown. You will notice this list is the same as the list above from the Pipe Connector properties.
When Connector Description is selected, the logical operators can be used to match exact text or they can search text and evaluate based on what it contains.
Specify a value in the text box to complete this condition.
This rule will now evaluate all equipment families that contain Pipe Connectors. Any family with a Pipe Connector that contains a Connector Description with the word "Hot Water" would pass and move on to the Connection Point placement.
Connection Point Placement
Connection point placement is similar to rough-in placement with one main difference:
When the family receiving the connection point contains a Pipe Connector, the location of the Pipe Connector will be used in lieu of the placement location.
When the family receiving the connection point contains multiple Pipe Connectors, connection points will be placed on top of each Pipe Connector.
6. Using the Connect Rough-Ins Tool
Click on the Connect Rough-Ins button
A prompt will appear letting you know how many new Connection Arcs were created between plumbing rough-in families and plumbing connection points as well as how many were skipped.
Connection Arcs can be skipped for the following reasons:
- When the rough-in is less than 2" from the connection point.
6.1- Selecting a Piping Linetype
The Piping setting is a linetype setting used by the Connect Rough-Ins tool.
The Connect Rough-Ins tool creates an arc between the rough-in and the connection point of the same rule using the specified linetype.
To activate the Piping button 
, you must specify at least (1) rough-in and a connection point. Otherwise there is nothing to connect.
Once you see the , click it to show the dropdown.
Here you can select a linetype that you have created in your Revit project. Do not use a linetype that is used for anything other than the Connect Rough-Ins tool.
When the Connect Rough-In tool is used, it deletes all lines of the specified linetype and then replaces them with new arcs. For this reason, you should not use this line type for anything else in your project otherwise it will get deleted when you use the Connect Rough-Ins tool.
It is easy to create a new linetype using the Create New... option.
Select you linetype style name, color, thickness and pattern.
Click and the new linetype will be added to your Revit project and will be selectable in the Piping selector.
There are no placement options for the Piping or the Connect Rough-Ins tool.