An Account Object represents a single Ooyala Flex Account. An Account represents the highest level of scoping for Ooyala Flex Objects, and nothing can be accessed outside an Account. An Account is normally assigned to a company or business unit. An Account can consist of Sub-Accounts, Groups, Roles, Workspaces, and Users. Object Visibility is currently set at the Account level.

Most customisation of Ooyala Flex occurs at the Account level. The following properties can be set and viewed at Account level:

Owner: The person that created the User in the system.

Ooyala Flex Console URL: The URL is typically the Account name (with character escaping where necessary) pre-pended to the main Ooyala Flex Console domain. For example,

Metadata: Custom fields for managing basic Account details.

Theme: The theme controls the branding, look and feel of an Account.

Members: A collection of Users that belong to this Account.

Sub-Accounts: A collection of Sub-Accounts that belong to this Account.

Groups: A collection of Groups that belong to this Account.

Roles: A collection of Roles that belong to this Account.

Variants: Variants can be used to customise existing Object Types.

Properties: Supports the advanced configuration of Ooyala Flex at the Account level and also environmental variables.

The Master Account

The Master Account is immutable and always exists. This Account is created when a new Ooyala Flex platform is installed. The Master Account owns all other Accounts, and is only accessed by the Master User. A Master Account is primarily used for setting up other Accounts as well as system-wide configuration.

Creating an Account

1) Login in as MasterUser, or the owner of the Account that will be making the new Account or Sub-Account.

2) On the Toolbar, click the New option.

3) From the drop down, select Account.

4) In the Create new Account section, fill in the relevant details for the Account, such as a Name and an optional description.

5) Click Save to finalise.

6) Click Enable to enable the Account.

7) Set up any Properties for your new Account. In particular obtain and apply URLs.

When you create a new Account a default Workspace is created with the same name.


A sub-account represents an account that belongs to an existing account. Sub-accounts are useful, for example when an account that belongs to a single company needs to be split up into multiple business units with self-administration. An account can access all of the objects that belong to its sub-accounts.

Creating a Sub-Account

To create a sub-account, follow these steps:

Make sure you are logged into the account, in which you want to create the sub-account.

1) On the Toolbar, click the New option.

2) From the drop down, select Sub-Account.

3) In the Create New Sub-account section, fill in the relevant details for the sub-account, such as a name and an optional description.

4) Click Save to finalise.

5) Click Enable.

6) Once the sub-account is enabled, it is automatically available as a sub-account of the account you are in.

Note: You cannot associate a sub-account with multiple accounts.

Account Metadata

When you have created your Account, you can apply Metadata to that account, by clicking the Metadata Sub-tab, located in the Account Details screen.

When you click the Metadata sub-tab, you will see several Metadata fields. These fields deal with publish functionality, External Authentication, Authentication, and Analytics configuration for the Account.

The following Metadata fields are present for Accounts:

Field Field Type Mandatory Multiplicity Description
Publish complex 0..1 Define this to enable Publish functionality for this account

CDN Storage Resource

single option   The CDN storage resource to use for Publish file publishing
Limits complex   Account Limits


string   Maximum number of Users allowed in the Account


string   Maximum number of Actions allowed in the Account

Workflow Definitions

string   Maximum number of Workflow Definitions allowed in the Account


string   Maximum number of Sub-Accounts allowed in the Account
Notes complex 0..* Notes


string   The Date on which the note was written


string   The note
External Authentication complex 0..1 Define this to enable External Authentication for this account

Authentication Endpoint

string   The endpoint URL for the External authentication to use for this account.

Default Role

single option   Role to be assigned to new user.

Default Workspace

single option   The default workspace for the new user.

Workspace Membership

single option 0..1 The workspaces for the new user.

Default Country Code

string   The default country code for the new user, Example: "en" (English), "ja" (Japanese), "us" (United States)

Default Owner

single option   Owner to be assigned to new user.

Authentication Provider

single option   Authentication Provider


complex   Definition of the Authentication features and constraints

Lock Minutes

string   Define the lock time that should pass to unlock the account after several failed attempts to log in (#)

Maximum number of failed attempts

string   Define the maximum number of failed attempts before lock the user (#)

Maximum number of forced attempts

string   Define the total number of failed login attempts before the user's account is disabled. (#)


complex   Definition of the password constraints

Days to expire

string   Amount of days a password expires after been defined (#)

Maximum password length

string   The maximum amount of characters that the password should contains (#)

Minimum password length

string   The minimum amount of characters that the password should contains (#)

Type of Password Validation

single option   Define the mechanism used to validate the password

Validation Types

complex   Definition of the password constraints

Type of Sequence

boolean   Type of sequence allowed to use in the password

Regular Expression

string   Regular expression to define the allowed characters on the password

Custom Configuration

boolean   Set of custom configuration available on the password validation process
Analytics configuration complex   Definition of the Authentication features and constraints

Web analytics collector URL

string   The endpoint URL for the Publish instance to use for sending events

Publish Token

    Token created in Publish to increase security.

Adjusting the theme

Once an Account has been created you have the ability to continue configuring it using the various sub-tabs located in the Details screen for the Account. One of the most useful sub-tabs is the Theme sub-tab. This allows you to customise the Ooyala Flex Console so that it matches your organisation's look and feel.

Note: Alternatively, you can access the Theme section, by clicking the Settings tab, and then selecting the Theme option from the toolbar.

You can adjust the following areas in the Theme sub-tab:

  • Summary
  • Links
  • Colours
  • Images

To adjust the theme of your Account follow these steps:

1) In the details screen for the Account you wish to edit, click the Edit option.

2) Click the Theme sub-tab, and click the Edit option.


Summary Includes: Name, Description, and Company Name

You can change the summary text by deleting the default text, and then entering new text. The Name and Company Name fields are mandatory, and must be filled in.


The Links section includes: Logo URL, Header Link URL, and Help Link URL. You can change the links for the various fields, by entering a valid URL.


The Colours section includes: Header Text, Header Background, Tabbed Navigation, Table Header Background etc. In order to change the colour for a particular area of Ooyala Flex, you can simply select the colour from the colour picker, or enter a hexadecimal colour code.


The images that can be changed are:

  • Login Logo
  • Main Logo
  • Client Splash Logo
  • Bookmark Icon
  • Client Logo

To add an image simply click the Choose File button next to the respective field, and select the image file.

Switching Accounts

1) In the Dashboard Tab, click your name located in the top-right corner of the screen.

2) In the User Details section, click the Switch tab.

3) In the Switch to Account field, select an Account from the drop down.

4) In the Workspace field, select a workspace.

5) Click Go.