Authoring Hub - Feature use cases

In the following example, a feature will be created to change the configuration of an item from a Door/Drawer to a Full Height Door.

The first step is to add an item from the Starter Catalog. You have more details of the step by step in the article How to add items into a catalog.

Double-clicking on the item will open the editing window, and under attributes, you'll be able to find the attribute that determines the configuration type. Click on System and Hide default value. The attribute will be listed, and you can copy the code and default value using the copy icon that appears when you hover your mouse over the text.

To know the value of the full height door, you can add an item in the same way with this configuration to check.

After it, create a feature from scratch, follow the steps on the article How to add features into a catalog. With the feature created, double-click on it and select the Schema tab. Select it to be visible, choose the base feature type (this will determined on which tab of the configuration this feature will appear), choose the selection type and add the options.

For this feature it is necessary to have two options, one as false, where there will be no itemModification (the item will continue to be a Door/Drawer), so don't need to add any attributes.

And a true option, with the configuration attribute set to Full High Door. Remember to always use the external reference code before the attribute, on the following example, it's used the letter "d".

You can find this external reference in the Dependencies catalog in Content Studio.

With the feature created, go to the item, select it and go to Actions and Link features.

Click on the feature created and on "Use 1 templates".

Click on the feature created and on "Use 1 templates".

Open 3D viewer and Configurator components. On the styles tab, you can change the value between true or false, as was set. 

Expected result:

First create a feature from scratch, follow the steps on the article How to add features into a catalog. With the feature created, double-click on it go on the Schema tab. Select it to be visible, choose the base feature type (this will determined on which tab of the configuration this feature will appear), choose the selection type and define the default Option Code.

Within options, you can add as many as you need. To do this, click Options and then +Add an option.

Within the option, place the code and in the Modification item, add all the necessary attributes. In this case, all the door style attributes will be registered. In this first option, the value 8 will be used. Then add as many options as you want by doing the same process.

With all the feature options created, go to the Item tab and click on the desired item, Actions and Link features.

Choose the feature that was created and click Use x templates.

Expected result:
Open the 3D Viewer and the Configurator, open the Styles tab and select the created feature, there you can change the door style.

Once an item with geometry is created and its main attributes are configured, you can add features to define its customizable properties. For instructions on creating an item, see this article.

Features control options such as style, dimensions, materials, and other configurable aspects of the item. This article explains how to add and configure features for your items.

Go to the Features tab and click + Add Feature .

Click Create Features from scratch.

Make sure the feature has the correct selectionType:

• singleSelect – allows the user to select one option from a list
• toggle – provides two options for true/false states
• customNumeric – only the first attribute in itemModification sets the numeric value

Add baseFeatureType of the feature in classification section.

Adding new options

1. Go to the Options tab and click + Add option.

2. Choose an existing option from the list or click Create option from scratch to create a new one.

3. Enter the Name for the new option and click Create option.

Configuring layer modifications

Once the option is created, go to the Layers tab and click + Add layers to specify which layers this option affects and how.

To make an option change the material of a layer:

In order to make an option change the material of any layer

1. Open the 3D Authoring Viewer (for detailed instructions, see this article).
2. In the 3D Authoring Viewer, open the Layers panel by clicking the arrow on the right side (1).
3. Copy the required layer name (2).
4. Paste the layerName and materialRef to appropriate fields. 

Once the feature is created, go to the Items tab, select the required item and go to its Features tab. 

Click + Add features and select the created feature from the list.

Click the arrow next to a feature name to expand and view its details and options.

This section explains how to create a feature that allows users to control a dimension value, such as drawer front height.

Example: Controlling drawer height

To control the height of a drawer, create a new feature Front Height and configure it as follows:

Step 1: Create and configure the feature

1. Create a new feature in Features tab (e.g., Front Height). Find more details on feature creation in this article.
2. Configure the feature settings:

Step 2: Create an option

This feature needs to change an attribute. Under the Options tab, create a single option (e.g., Front Height).

The option should change the attribute that controls the drawer height.

Step 3: Find the attribute

Option A: Check documentation

Search for the attribute in the Item Construction - Dimensioning article.

Option B: Use the Design Item List

If the attribute is not found in documentation:

1. Open the item and go to the Design Item List 
2. Expand the tree to see the item configuration. For easier navigation, turn off Compact Mode.
3. Find the drawer in the tree
4. Check its height and height formula

5. Note the attribute name from the formula

   

Step 4: Add the attribute to the option

1. Open the option
2. Go to the Attributes tab
3. Find and add the attribute identified in the previous step

4. Set the min and max values for the attribute

   

Step 5: Link the feature to the item

1. Open the item
2. Go to the Features tab

3. Link the Front Height feature to the item

   

Step 6: Test in configurator

Open the item in the Configurator. The feature appears in the Dimensions tab because the baseFeatureType is set to dimension.

Feature classification and configurator tabs

The baseFeatureType determines where the feature is displayed in the configurator.

Available baseFeatureType values

Changing the baseFeatureType from dimension to subitem moves the feature from the Dimensions tab to the Subitems section in the configurator.