Load Metadata from an Alteryx Promote Node

Last modified: March 27, 2020

Use the Alteryx Promote Loader to upload metadata to Alteryx Connect for a specified Promote account.

Review Loader Requirements

The Alteryx Connect Loaders must be installed on the machine where Alteryx Server is installed. To install the loaders:

  1. Download the loaders installer. For compatibility, the Loaders installer version must match the Alteryx Connect version.
  2. Run the installer as an administrator.

The Promote loader requires an API key. After logging into the Promote node:

  1. Click your account picture in the top-right corner.
  2. Select My Account.
  3. Copy your API key.

Open the Loader

  1. Open Alteryx Designer.
  2. Click Help > Sample Workflows > Alteryx Connect Metadata Loaders > Promote Loader > Promote Loader.

Run the App

  1. Click Run as Analytic App Run as analytic app button

  2. In the Promote node tab:

    • Type the Promote URL.
    • Type the Promote Username.
    • Enter the Promote API key.
  3. In the Alteryx Connect tab, type the URL for your Alteryx Connect instance and your credentials.


  4. Before running the app, click Save button and save the app configuration to the following directory:


    The .yxwv app values file is used for scheduling the loader to run in the Gallery. See Schedule Metadata Loaders.

  5. Click Finish to run the app.
    • If the run succeeds, "Success" appears in the App Results window.
    • If the run fails, a "There were Errors" message appears.

    Depending on how much metadata is being imported, the app can take a long time to run.

View the Metadata

  1. Go to the Alteryx Connect URL and log in.
  2. From the main menu, click Data Sources > Promote Models.
  3. Select a folder to view its contents.
Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.