# Edit (composable) blueprints

> Edit (composable) blueprints - Describes how to build custom blueprints using built-in tasks and
> custom Python/R code.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-05-06T18:17:10.068636+00:00` (UTC).

## Primary page

- [Edit (composable) blueprints](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/experiment-cml.html): Full documentation for this topic (HTML).

## Sections on this page

- [Edit a blueprint](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/experiment-cml.html#edit-a-blueprint): In-page section heading.
- [Editor panel](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/experiment-cml.html#editor-panel): In-page section heading.
- [Train the new blueprint](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/experiment-cml.html#train-the-new-blueprint): In-page section heading.
- [Feature considerations](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/experiment-cml.html#feature-considerations): In-page section heading.

## Related documentation

- [NextGen UI documentation](https://docs.datarobot.com/en/docs/workbench/index.html): Linked from this page.
- [Workbench](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/index.html): Linked from this page.
- [Predictive experiments](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/index.html): Linked from this page.
- [Manage experiments](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/index.html): Linked from this page.
- [Blueprint](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/experiment-insights/model-blueprint.html): Linked from this page.
- [Train it, any time, from the blueprint repository](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/blueprint-repo.html): Linked from this page.
- [DataRobot Classic documentation](https://docs.datarobot.com/en/docs/classic-ui/modeling/special-workflows/cml/index.html): Linked from this page.
- [overview](https://docs.datarobot.com/en/docs/classic-ui/modeling/special-workflows/cml/cml-overview.html): Linked from this page.
- [quickstart](https://docs.datarobot.com/en/docs/classic-ui/modeling/special-workflows/cml/cml-quickstart.html): Linked from this page.
- [Creating custom tasks](https://docs.datarobot.com/en/docs/classic-ui/modeling/special-workflows/cml/cml-custom-tasks.html): Linked from this page.
- [Creating custom environments](https://docs.datarobot.com/en/docs/classic-ui/modeling/special-workflows/cml/cml-custom-env.html): Linked from this page.
- [Validation schema](https://docs.datarobot.com/en/docs/reference/pred-ai-ref/cml-ref/cml-validation.html): Linked from this page.
- [nodes](https://docs.datarobot.com/en/docs/classic-ui/modeling/special-workflows/cml/cml-blueprint-edit.html#modify-a-node): Linked from this page.
- [change them](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/experiment-add.html#train-on-new-settings): Linked from this page.
- [composable ML considerations](https://docs.datarobot.com/en/docs/reference/pred-ai-ref/cml-ref/cml-consider.html): Linked from this page.

## Documentation content

Composable blueprints provide a full-flexibility approach to model building so that you can direct your data science and subject matter expertise to the models you build. Editing blueprints using built-in tasks and custom Python/R code allows you to use your new blueprint together with other DataRobot capabilities (MLOps, for example) to boost productivity.

A blueprint represents the high-level end-to-end procedure for fitting the model, including any preprocessing steps, modeling, and post-processing steps. This section describes the blueprint editor, accessed from a model's [Blueprint](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/experiment-insights/model-blueprint.html) insight; see that tab for a detailed description of blueprint elements.

The sections below describe how to [edit a blueprint](https://docs.datarobot.com/en/docs/workbench/nxt-workbench/experiments/manage-experiments/experiment-cml.html#edit-a-blueprint) and, once you have created a new blueprint, either:

- Train it directly from within the blueprint .
- Train it, any time, from the blueprint repository .

See the [DataRobot Classic documentation](https://docs.datarobot.com/en/docs/classic-ui/modeling/special-workflows/cml/index.html) for full details about editing, including:

- Custom blueprint overview and quickstart .
- Creating custom tasks .
- Creating custom environments .
- Validation schema .

## Edit a blueprint

To edit a blueprint:

1. From the Leaderboard, select a model and then select theBlueprinttab. ClickEdit blueprint:
2. Modify, add, or delete the blueprint'snodesand/orconnectors. First, click the node: Select a desired action: ActionDescriptionModify a nodeChange characteristics of the task contained in the node.Hover over a node and click the associated pencil icon.Edit the taskor parameters as needed.Add a nodeAdd a node to the blueprint.Hover over the node that will serve as the new node's input and click the plus sign. This creates a new branch with an empty node. Use the accompanyingSelect a taskwindow toEdit the task.Connect nodesConnect tasks to direct the data flow.Hover over the starting point node, drag the diagonal arrow iconto the end point node, and click.Remove a nodeRemove a node and its associated task from the blueprint, as well as downstream nodes.Hover over a node and click the associated trash can. If you remove a node, its entire branch is removed (all downstream nodes). NoteIf an action isn't applicable to a node, the icon for the action is not available. Also, use the redo/undo tools as needed.
3. Resolve any errors, reported in red: NoteWhen you modify tasks or connectors to create your own blueprints, DataRobot validates those modifications. This is to ensure that changes are intentional, not to enforce requirements. As such, blueprints with validation warnings (yellow) are saved and can be trained, despite the warnings. While this flexibility prevents erroneously constraining you, be aware that a blueprint with warnings may not successfully build a model.
4. When the modified blueprint has no errors, clickNextto proceed totraining settings. Either:

### Editor panel

The right panel includes fields for adding a name and description to the new blueprint. By default, the blueprint inherits the name of the original. It you use the default name, the field can be identified in the repository by the Customized badge.

Additionally, blueprint validation message shortcuts are listed. Click a badge to open the full, corresponding warning or error in the blueprint.

## Train the new blueprint

This section describes training options for the new blueprint from within the Edit blueprint modal.

Set the Train blueprint after saving toggle to control whether the blueprint is trained once you save it:

- Whenenabled, the training settings are modifiable. You canchange themor not, and when you clickSave blueprint, DataRobot trains a new model with those settings. DataRobot then adds the new model to the Leaderboard and writes the blueprint to the repository.
- Whendisabled, the training settings are also disabled. DataRobot saves the blueprint to theblueprint repositoryfor training at a later time.

## Feature considerations

Composable blueprints support the following:

- Predictive ML, including time-aware but not time series, and Feature Discovery.
- Estimators, both built-in and custom, are available for binary classification, regression, and multiclass experiments.
- Preprocessing, both built-in and custom.

Refer to the [composable ML considerations](https://docs.datarobot.com/en/docs/reference/pred-ai-ref/cml-ref/cml-consider.html) for a complete list of feature compatibilities.