# Register custom models

> Register custom models - Add a custom model to the NextGen Registry.

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.045731+00:00` (UTC).

## Primary page

- [Register custom models](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-directory/nxt-register-cus-models.html): Full documentation for this topic (HTML).

## Sections on this page

- [Register a model from the workshop](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-directory/nxt-register-cus-models.html#register-a-model-from-the-workshop): In-page section heading.
- [Register a model from Registry](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-directory/nxt-register-cus-models.html#register-a-model-from-registry): In-page section heading.
- [Custom model build troubleshooting](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-directory/nxt-register-cus-models.html#custom-model-build-troubleshooting): In-page section heading.

## Related documentation

- [NextGen UI documentation](https://docs.datarobot.com/en/docs/workbench/index.html): Linked from this page.
- [Registry](https://docs.datarobot.com/en/docs/workbench/nxt-registry/index.html): Linked from this page.
- [Models](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-directory/index.html): Linked from this page.
- [custom model](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-workshop/index.html): Linked from this page.
- [deploy the model](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-directory/nxt-deploy-models.html): Linked from this page.

## Documentation content

After you create a [custom model](https://docs.datarobot.com/en/docs/workbench/nxt-registry/nxt-model-workshop/index.html), you can register it from the workshop or directly in Registry. If a registered model already exists to solve a specific business problem, you can add new custom models solving the same problem as registered model versions, providing a model management experience organized by problem type.

## Register a model from the workshop

To register a custom model from the workshop:

1. In theRegistry, on theWorkshoptab, click the model you want to register, and then clickRegister a model:
2. On theRegister a modelpage, underConfigure the model, theTargetandTarget typeare set based on the model you're registering. Select one of the following registration options: Then, configure the following fields: FieldDescriptionRegistered model name / Registered modelDo one of the following:Registered model name:When registering a new model, enter a descriptive name for the new registered model. Note that the name does not need to be unique.Registered model:When saving as a version of an existing model, select the existing registered model you want to add a new version to.Registered version nameAutomatically populated with the model name, date, and time. Change or modify the name as necessary.Registered model versionAssigned automatically. This displays the expected version number of the version (e.g., V1, V2, V3) you create. This is alwaysV1when you selectRegister as a new model.Optional settingsRegistered version descriptionEnter a description of the business problem this model package solves, or, more generally, describe the model represented by this version.TagsClick+ Add tagand enter aKeyand aValuefor each key-value pair you want to tag the modelversionwith. Tags added when registering a new model are applied toV1. NoteIf you clickCancelon this page to return to theRegistry, you lose the configuration progress on this page.
3. ClickRegister Model. The model version opens on theRegistry > Modelspage with aBuildingstatus. You candeploy the modelat any time.

## Register a model from Registry

To register a custom model from Registry:

1. In theRegistry, on theModelstab, click+ Register a model(or thebutton when the registered model or version info panel is open): TheRegister a modelpanel opens to theExternal modeltab.
2. Click theCustom modeltab and then, underConfigure the model, select one of the following options: Then, configure the following fields: FieldDescriptionCustom modelSelect the custom model you want to register from theworkshop.Custom model versionSelect the version of the custom model to register.Registered model name / Registered modelDo one of the following:Registered model name:When registering a new model, enter a unique and descriptive name for the new registered model. If you choose a name that exists anywhere within your organization, a warning appears.Registered model:When saving as a version of an existing model, select the existing registered model you want to add a new version to.Registered version nameAutomatically populated with the model name, date, and time. Change or modify the name as necessary.Registered model versionAssigned automatically. This displays the expected version number of the version (e.g., V1, V2, V3) you create. This is alwaysV1when you selectRegister as a new model.Optional settingsRegistered version descriptionEnter a description of the business problem this model package solves, or, more generally, describe the model represented by this version.TagsClick+ Add tagand enter aKeyand aValuefor each key-value pair you want to tag the modelversionwith. Tags added when registering a new model are applied toV1. NoteIf you clickCancelon this page to return to theRegistry, you lose the configuration progress on this page.
3. ClickRegister Model. The model version opens on theRegistry > Modelspage with aBuildingstatus. You candeploy the modelat any time.

## Custom model build troubleshooting

If the custom model build completes with a Build failed status, you can troubleshoot the failure using the model logs. To access the model logs, in the Insight computation failed warning, click Open the workshop:

The Workshop opens to the Versions tab for the custom model you registered, with the version panel open to the Insights section. Next to the Status field, locate the Logs and click Model logs to open the model logs console:

In the Console Log: Model logs modal, review the timestamped log entries:

|  | Information | Description |
| --- | --- | --- |
| (1) | Date / time | The date and time the model log event was recorded. |
| (2) | Status | The status the log entry reports: INFO: Reports a successful operation.ERROR: Reports an unsuccessful operation. |
| (3) | Message | The description of the successful operation (INFO), or the reason for the failed operation (ERROR). This information can help you troubleshoot the root cause of the error. |

> [!NOTE] Model logs consideration
> In the Registry, a model package's Model logs only report the operations of the underlying model, not the model package operations (e.g., model package deployment time).

If you can't locate the log entry for the error you need to fix, it may be an older log entry not shown in the current view. Click Load older logs to expand the Model logs view.

> [!TIP] View older logs
> Look for the older log entries at the top of the Model logs; they are added to the top of the existing log history.