# Promoting assets to a deployment space #

Learn about how to promote assets from a project to a deployment space and the requirements for promoting specific asset types\.

## Promoting assets to your deployment space ##

You can promote assets from your project to a deployment space\. For a list of assets that can be promoted from a project to a deployment space, refer to [Adding assets to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets-all.html)\. When you are promoting assets, you can:

<!-- <ul> -->

 *  Choose an existing space or create a new one\.
 *  Add tags to help identify the promoted asset\.
 *  Choose dependent assets to promote them at the same time\.

<!-- </ul> -->

Follow these steps to promote your assets to your deployment space:

<!-- <ol> -->

1.  From your project, go to the **Assets** tab\.
2.  Select the **Options** (![Options icon](https://dataplatform.cloud.ibm.com/docs/content/wsj/refinery/images/actions.png)) icon and click **Promote to space**\.

<!-- </ol> -->

Tip: If the asset that you want to promote is a model, you can also click the model name to open the model details page, and then click Promote to deployment space\.

**Notes:**

<!-- <ul> -->

 *  Promoting assets and their dependencies from a project to a space by using the Watson Studio user interface is the recommended method to guarantee that the promotion flow results in a complete asset definition\. For example, relying on the [Watson Data API](https://cloud.ibm.com/apidocs/watson-data-api-cpd) to manage the promotion flow of an asset, together with its dependencies, can result in the promoted asset from being inaccessible from the space\.
 *  Promoting assets from default Git\-based projects is not supported\.
 *  Depending on your configuration and the type of asset that you promote, large asset attachments, typically more than 2 GB, can cause the promotion action to time out\.

<!-- </ul> -->

For more information, see:

<!-- <ul> -->

 *  [Promoting connections and connected data](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-promote-assets.html?context=cdpaas&locale=en#promo-conn)
 *  [Promoting models](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-promote-assets.html?context=cdpaas&locale=en#promo-model)
 *  [Promoting notebooks and scripts](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-promote-assets.html?context=cdpaas&locale=en#promo-nbs)

<!-- </ul> -->

## Promoting connections and connected data ##

When you promote a connection that uses personal credentials or Cloud Pak for Data authentication to a deployment space, the credentials are not promoted\. You must provide the credentials information again or allow Cloud Pak for Data authentication\. Because Storage Volume connections support only personal credentials, to be able to use this type of asset after it is promoted to a space, you must provide the credentials again\.  
  
Some types of connections allow for using your personal platform credentials\. If you promote a connection or connected data that uses your personal platform credentials, tick the *Use my platform login credentials* checkbox\.  
  
Although you can promote any kind of data connection to a space, where you can use the connection is governed by factors such as model and deployment type\. For example, you can access any of the connected data by using a script\. However, in batch deployments you are limited to particular types of data, as listed in [Creating a batch deployment](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/deploy-batch-details.html)\.

## Promoting models ##

When you promote a model to a space:

<!-- <ul> -->

 *  Components that are required for a successful deployment, such as a custom software specification, model definition, or pipeline definition are automatically promoted as well\.
 *  The data assets that were used to train the model are not promoted with it\. Information on data assets used to train the model is included in model metadata\.

<!-- </ul> -->

## Promoting notebooks and scripts ##

Tip: If you are using the Notebook editor, you must save a version of the notebook before you can promote it\.

<!-- <ul> -->

 *  If you created a job for a notebook and you selected **Log and updated version** as the job run result output, the notebook cannot be promoted to a deployment space\.
 *  If you are working in a notebook that you created before IBM Cloud Pak for Data 4\.0, and you want to promote this notebook to a deployment space, follow these steps to enable promoting it:
    
    <!-- <ol> -->
    
    1.  Save a new version of the notebook.
    2.  Select the newly created version.
    3.  Select either **Log and notebook** or **Log only** as the job run result output under **Advanced configuration**.
    4.  Run your job again.
        
        Now you can promote it manually from the project **Assets** page or programmatically by using CPDCTL commands.
    
    <!-- </ol> -->
    
<!-- </ul> -->

<!-- <ul> -->

 *  If you want to promote a notebook programmatically, use CPDCTL commands to move the notebook or script to a deployment space\. To learn how to use CPDCTL to move notebooks or scripts to spaces, refer to [CPDCTL code samples](https://github.com/IBM/cpdctl/tree/master/samples)\. For the reference guide, refer to [CPDCTL command reference](https://github.com/IBM/cpdctl/blob/master/README_command_reference.md#notebook_promote)\.

<!-- </ul> -->

**Parent topic:**[Assets in deployment spaces](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets-all.html)

<!-- </article "role="article" "> -->