Skip to main content





How to set up Experience Builder

Learn how to set up Experience Builder.


To use Experience Builder, make sure the following prerequisites are met.

Your environment

To set up and use Experience Builder your environment must comply with the following prerequisites:

Your user

You must have an IT user with Change and Deploy Application and Create Applications permissions for the environment.

Your device

You can access Experience Builder with the latest versions of the following desktop browsers:

  • Edge.
  • Firefox.
  • Google Chrome.
  • Safari.

Log in for the first time

When you log in to Experience Builder for the first time you enter the following welcome screen:

To log in to Experience Builder, perform the following steps.

  1. Enter the address of your OutSystems development environment in the Environment field.

    Use a non-production environment with Experience Builder, preferably your development environment.
    When you publish an app in Experience Builder, the app is published in the environment you entered in the log in.

  2. Enter your IT user credentials.

  3. Click on the Login button.

Registering your infrastructure

As a first user from your organization logging in, you first need to register your environment. The registration procedures vary, depending on the Platform Version installed in the environment.

To begin registering your infrastructure in Experience Builder, perform the following steps:

  1. Click on the Register Environment button.

  2. Read the Experience Builder disclaimer and GDPR information carefully. To proceed, click on the Accept and continue button.

  3. Depending on your Platform Server release and your user role in Lifetime, there are two scenarios:

    • Experience Builder collects all data from your infrastructure automatically. Check the information displayed, and click on the Register button.

    • Enter your infrastructure activation code, and click on the Register button. Then, Proceed to Step 4. To learn how to get your activation code, refer to Find the Activation Code of your infrastructure.

  4. Download the Experience Builder Components package using the link provided on the screen.

  5. In the Service Center console of the Development Environment (https://<development_environment>/ServiceCenter), install the downloaded .osp file in your Development environment by following these steps:

    1. Click on Factory.
    2. Click on Solutions.
    3. Select Upload & Publish a Solution.
    4. Select Choose File and select the .osp file.
    5. Click the 1-Click Publish button.
  6. Validate if the Solution is successfully published by checking for a Done: The solution was successfully published message, and go back to the Experience Builder setup page.

  7. Click on the checkbox to confirm you completed all the steps, and then click on the Next button.

  8. Share Experience Builder with your IT users. To allow an Experience Builder user to generate an app, they’ll need to have an IT user created in your Infrastructure with permission to Change & Deploy Applications in the Development Environment.

  9. The Experience Builder registration is complete. Click on the Go to Experience Builder button to enter the tool.

    When you enter the tool, a background process installs the Experience Builder components required to publish the apps.

    Experience Builder components installation

    If the Experience Builder components installation fails, you need to install the components manually. Read How to install or update dependencies to learn about it.

    Experience Builder components installation fail

  10. The Experience Builder registration is complete.

Granting access to IT users

To publish apps with Experience Builder, IT users must have permission to Change & Deploy Applications in the development environment.

Ensure you send your users the following information:

  • Was this article helpful?