Get Started with Oracle Visual Builder Generation 2

Oracle Visual Builder is a cloud-based software development Platform as a Service (PaaS) and a hosted environment for your application development infrastructure. It provides an open-source standards-based solution to develop, collaborate on, and deploy applications within Oracle Cloud. To use Visual Builder you should be familiar with the tools available for building your applications.

Visual Builder Generation 2 refers to Visual Builder running natively on Oracle Cloud Generation 2 infrastructure.


It’s important that you determine if you’re running on Gen 2 so you know which guide to read for set-up instructions. Let’s do a quick test: Open the OCI console, then open Developer Services. Scan the list for Visual Builder. If you don’t see it, that means you’re not running on Gen 2 and you should refer to Getting Started in Administering Oracle Visual Builder to create and configure Visual Builder instances instead of this guide. If you do see it, then this guide is the one you need.

What is Oracle Visual Builder?

Oracle Visual Builder is an intuitive development experience on top of a development and hosting platform that empowers you to create engaging responsive applications. Focusing on ease of use and a visual development approach, it provides an easy way for you to create applications that are hosted in Oracle’s secure and scalable cloud platform.

Visual Development Experience

Visual Builder provides simple but powerful visual development tools to create responsive apps—all without the need to install any additional software. This rich set of visual tools help you quickly design your app by dragging and dropping UI components and customizing their attributes to define behavior. While these tools lend themselves to low-code developers, experienced developers can just as easily access the underlying source code, even extend it using standard HTML5, JavaScript, and CSS techniques for complex needs.

Easy Access to Data

Visual Builder makes it easy to access your app’s data through REST-based services. So you can create reusable business objects to implement your app’s business logic and store its data, which can then be managed through REST endpoints that Visual Builder generates for you. Or you can pick data objects exposed by Oracle SaaS or Oracle Integration applications in an integrated catalog of REST services. You can also access data from any external REST service with just a few clicks.

Development and Hosting Platform

Visual Builder is a complete development tool as well as a hosting platform, which means you can manage your application’s lifecycle right from development to test and final publishing. Version management and data migration are built into an app’s lifecycle, making it easy for you to stage and publish your app and manage its data in every phase.

What’s more, Visual Builder is a managed service. This means that once you provision a Visual Builder instance, there’s very little you need to do beyond developing and publishing your app. Everything the app needs to run successfully (including a web server to host your application and to secure data access) is taken care of. Thus, as a development team, you can take your app from development to stage and publish it in a very short time. Here’s a high-level walkthrough of how you’d go about developing an app using Visual Builder:

Description of vbcs-architecture.png follows

Your Visual Builder instance (represented by the square in the middle of the image) provides capabilities for your visual application both as a visual development tool (at the top) as well as an app hosting platform with a built-in web server (indicated by server-side components at the bottom):

  • As a visual development tool, Visual Builder provides access to UI components and WYSIWYG interfaces that leverage the open-source Oracle JavaScript Extension Toolkit (JET). This visual environment, known as the Designer, features several visual editors that a development team can use to collaboratively build rich UIs that span multiple devices. It also supports Redwood, the Oracle standard for user experience, that lets you develop apps that provide the same look and feel as apps delivered from Oracle.

    Within this environment, you can develop browser-based responsive apps, including progressive web apps, which combine the on-device mobile experience with a web app’s ease of distribution—eliminating the need to download updates from app stores.

  • As an app hosting platform, Visual Builder provides various capabilities to publish and run your app in the cloud, including an embedded database that stores your app’s business objects—essentially Oracle tables with business logic exposed through REST APIs—and their data.

    It also includes a REST proxy service to manage access to external REST endpoints. When your app’s data comes from REST APIs in Oracle catalogs such as Oracle SaaS or Oracle Integration, the proxy service uses server-side integration with the Oracle Identity Cloud Service (IDCS) to manage authentication and authorization (by default) through identity propagation. When your app’s data comes from other REST endpoints, authenticated REST mechanisms are used to manage credentials.

    Together, these components provide the resources required to host your visual app and manage its data.

When your apps are published, they become available to your users in the cloud, from any desktop or mobile device, with communication to the app’s underlying JET components secured over HTTPS and REST.

How to Begin with Visual Builder Subscriptions

Here's a summary of the key steps to help Oracle Cloud account administrators get started with Visual Builder:

  1. Sign up for a free credit promotion or purchase a subscription. See Request and Manage Free Oracle Cloud Promotions or Buy an Oracle Cloud Subscription in Oracle Cloud Infrastructure Documentation.
  2. Sign in to your Cloud Account. See Signing In to the OCI Console.
  3. Create accounts for your users and assign them appropriate privileges and roles. See Managing Users, User Accounts, and Roles in Managing and Monitoring Oracle Cloud.


Visual Builder Generation 2 is currently available in the regions listed below.

Geography Region Location Region Key
APAC Australia East (Sydney) SYD
APAC Australia Southeast (Melbourne) MEL
APAC Canberra WGA
APAC South Korea North (Chuncheon) YNY
APAC South Korea Central (Seoul) ICN
APAC Japan Central (Osaka) KIX
APAC Japan East (Tokyo) NRT
APAC India West (Mumbai) BOM
APAC India South (Hyderabad) HYD
APAC Singapore (Singapore) SIN
APAC Chiyoda NJA
APAC Ibaraki UKB
EMEA Switzerland North (Zurich) ZRH
EMEA Germany Central (Frankfurt) FRA
EMEA Netherlands Northwest (Amsterdam) AMS
EMEA Saudi Arabia West (Jeddah) JED
EMEA Oman (Muscat) MCT
EMEA UAE Central (Abu Dhabi) AUH
EMEA UAE East (Dubai) DXB
EMEA UK South (London) LON
EMEA UK West (Newport) CWL
EMEA UK Gov South (London) LTN
EMEA UK Gov West (Cardiff) BRS
EMEA Israel Central (Jerusalem) MTZ
EMEA France Central (Paris) CDG
EMEA France South (Marseille) MRS
EMEA South Africa Central (Johannesburg) JNB
EMEA Italy Northwest (Milan) LIN
EMEA Milan 1 BGY
EMEA Milan 2 MXP
EMEA Dublin 1 ORK
EMEA Dublin 2 SNN
EMEA Rating 1 DUS
EMEA Rating 2 DTM
EMEA Madrid 2 VLL
EMEA Frankfurt 2 STR
EMEA Spain (Madrid) MAD
EMEA Serbia Central (Jovanovac) BEG
EMEA Sweden Central (Stockholm) ARN
LAD Brazil East (Sao Paulo) GRU
LAD Brazil Southeast (Vinhedo) VCP
LAD Chile Central (Santiago) SCL
LAD Mexico Central (Queretaro) QRO
LAD Mexico (Monterey) MTY
North America US East (Ashburn) IAD
North America US Midwest (Chicago) ORD
North America US West (San Jose) SJC
North America US West (Phoenix) PHX
North America US East Ashburn RIC
North America US Chicago PIA
North America US Phoenix TUS
North America US Tacoma TIW
North America West Jordan SGU
North America Phoenix 1 IFP
North America Phoenix 2 GCN
North America Phoenix 4 YUM
North America Canada Southeast (Toronto) YYZ
North America Canada Southeast (Montreal) YUL

Service Limits

When you sign up for Oracle Cloud Infrastructure, a set of service limits is configured for your tenancy. The service limit is the quota or allowance set on a resource. Review the following service limits for Visual Builder Generation 2 resources.

Resource Service Limit
Visual Builder instance count 200 instances per region

To learn more about service limits, see Service Limits.

Visual Builder for SaaS

Visual Builder for Oracle SaaS, a streamlined version of Visual Builder, gives you the features and benefits of Visual Builder with a focus on SaaS.

You might see Visual Builder instances in your environment that were provisioned as part of an Oracle Cloud Application that your organization licensed. These specific Visual Builder for SaaS instances come with specific restrictions: Every Visual Builder application you create must use at least one business object or API call from an Oracle Cloud SaaS application, and every process application you create must include at least one business object or API call from an Oracle Cloud SaaS application.