Occurrences.addFromCustomConfiguration Method

Parent Object: Occurrences

Preview This functionality is provided as a preview of intended future API capabilities. You are encouraged to use it and report any problems or suggestions using the Fusion API and Scripts forum.

Because this is a preview of future functionality, there is the possibility that it will change, which will possibly break any existing programs that use this functionality. Because of that, you should never deliver any programs that use any preview capabilities. For a distributed program, you should wait until it has moved from preview to released state.

Defined in namespace "adsk::fusion" and the header file is <Fusion/Components/Occurrences.h>

Description

Method that inserts a configuration from a configured design with custom values that override specific column values and optional metadata such as name, part number, and description. Note: custom name, part number, and description are not supported in R1. The insert will fail if the configured design being used is not from the same project as the file it is being inserted into.

"occurrences_var" is a variable referencing an Occurrences object.

returnValue = occurrences_var.addFromCustomConfiguration(configurationRow, customValues, transform)

"occurrences_var" is a variable referencing an Occurrences object.

#include <Fusion/Components/Occurrences.h>

returnValue = occurrences_var->addFromCustomConfiguration(configurationRow, customValues, transform);

"occurrences_var" is a variable referencing an Occurrences object.

returnValue = occurrences_var.addFromCustomConfiguration(configurationRow, customValues, transform);

Return Value

Type	Description
Occurrence	Returns the newly created occurrence or null if the add failed.

Parameters

Name	Type	Description
configurationRow	ConfigurationRow	The row that specifies which configuration to use.
customValues	CustomConfigurationValues	A CustomConfigurationValues object providing per-column value overrides (keyed by column ID) and optional metadata (name, part number, description).
transform	Matrix3D	A transform that defines the location for the new occurrence.

Version

Introduced in version July 2026