Content

Consistency across products plays a big role in the user experience. This glossary provides a lightweight reference for common UI terms and action labels.

    AA

    add

    Adds an existing object to a list, container, or system (for example, adding a document to a folder).

    Combine Add with the object (for example, Add user, Add space, Add role, or Add privileges). Contrast with Insert and New. See the Add action.

    apply

    Saves changes without closing the dialog. These properties often affect subsequent system behavior.

    Use instead of Save Changes. Contrast with Save and Save As.

    approve

    Indicates the user agrees. In a business process, typically initiates the next step.

    See Reject.

    BB

    back

    Returns the user to the previous step in a sequence of steps, such as in a wizard.

    Use instead of Previous. See Next and Finish.

    browse

    Assists the user in entering a file name or file path (for example, on a button or link next to an entry field). Typically opens a secondary window where the user can locate and select the desired directory and file.

    CC

    cancel

    Stops the current action and closes the dialog.

    Warn the user of any possible negative consequences of stopping an action from progressing, such as data corruption. See Reset and the Cancel action.

    clear

    This action clears all the fields or selections. Also deletes the contents of a document, such as a log. Typically the default selection or value is re-established for controls that always have a selection or value, such as Radio Buttons.

    Where appropriate, combine Clear with the object (for example, Clear contents, Clear fields, Clear all). Contrast with Delete and Remove. See the Clear action.

    close

    Closes the current page or window (for example, closing a secondary window containing online help).

    Do not use Close together with OK or Cancel actions. Contrast with Done. See Cancel and the Close action.

    copy

    Creates new instances of the selected objects to a specific destination.

    Combine Copy with the object being copied (for example, Copy folder) or the destination (for example, Copy to clipboard) if there are multiple possibilities. Use instead of Create like. Contrast with New. See the Copy action.

    create

    Label for a button in a dialog or form that creates a new object. The settings in the dialog are applied to the object when it is created.

    Use New to initiate the action of creating a new object. Use Create to confirm the action after any naming or configuration. Contrast with Add, Copy, and Insert.

    customize

    Allow a user to make desired changes.

    DD

    delete

    Destroys an existing object.

    Combine Delete with the object to delete (for example, Delete column or Delete table). Contrast with Clear and Remove. See the Delete action

    docs

    Opens a separate window containing the landing page for the Bluemix product documentation.

    Use as link text only for the specific link that points to the Bluemix product documentation from the console menu bar. See Learn More.

    done

    Indicates that the user has finished working in an environment (for example, editing templates) and wants to return to where he or she came from.

    See Finish. Contrast with Close.

    download

    Transfers a file from a remote system to a local system.

    See Upload.

    drop

    Use only for dropping a database table.

    In other cases, use Delete, Clear, or Remove.

    EE

    edit

    Allows data or values to be changed.

    See the Edit action.

    empty trash

    Permanently deletes all files or objects that have been placed into a trash container.

    See Move to trash.

    export

    Saves data in a different format external to the system. Typically opens a secondary window for the user to specify the file type and destination (for example, storing table data as a set of comma-separated values).

    See Import.

    FF

    filter

    Shortens a list to objects that match the filter criteria.

    Contrast with Find and Search.

    find

    Moves the cursor to the next element matching the specified criteria (for example, view the next occurrence of a specific word within an email message).

    Contrast with (Filter)(#filter) and Search.

    finish

    Indicates completion of a series of steps, such as in a wizard.

    See Done.

    GG

    get help

    Opens a search field from which the user can search for help information.

    Use only as link text on Support widget from the console menu bar. See Docs and Learn more.

    HH

    hide

    Removes an element that was previously shown.

    Context: Hide descriptions. See Show.

    II

    import

    Transforms data or objects from an external source. Typically opens a secondary window for the user to locate the external source.

    Context: Creating a new table based on comma-separated values contained in a separate file. See Export.

    insert

    Adds an element at a particular position in an ordered view.

    Context: Adding a picture to the body of a document or inserting a record into a table. Contrast with Add and New.

    LL

    launch

    Do not use.

    Use Start.

    learn more

    Opens additional, highly contextual information. Insert at the end of inline text or hover text where more information follows but does not fit in the current context.

    If space permits, combine Learn more with meaningful text that describes the content you're pointing to. For example, if your user needs some best practices to manage apps in multiple regions, you could use Learn more about regions.

    log in

    Enters a site or application. This choice typically opens a form for entry of credentials. Also used on the submission button after users enter their credentials.

    Use instead of Sign in. See Log out.

    log out

    Exits an application or site.

    Use instead of Sign out. See Log in.

    MM

    move

    Transfers an object from one container (for example, folder, activity, or page) to another.

    move to trash

    A soft delete. Moves a file or object to an area from where it can later be permanently deleted or recovered.

    Use instead of Delete or Recycle bin. See Empty trash.

    NN

    new

    Starts the creation of a new object. New either creates the object immediately or opens a dialog or set of fields where the user can enter properties.

    Combine New with the object to create (for example, New user or New column). See Create. Contrast with Add, Copy, and Insert.

    OO

    OK

    Confirms an action or completes the current task.

    Best practice is to use a label corresponding to the specific action (e.g. Save, Delete, etc.). Use OK only when such a label is not available. Write as shown: two letters, both uppercase.

    PP

    play

    Starts audio, video, or an animation.

    post

    Adds a new comment to an online community or adds status to a log or record.

    If you are editing an existing comment, use Save instead.

    preview

    Shows how an object or content will appear with formatting applied before the content is published or distributed. Alternatively, provides an incomplete display of an existing object without leaving the current context.

    print

    Sends a copy of the currently selected object or the object in view to the printer.

    RR

    redo

    Redoes an undo action.

    Likely used only as a Tooltip on an icon button. See Undo.

    refresh

    Reloads the view of an object when the displayed view has become unsynchronized with the source.

    Likely used only as a tooltip on an icon button. See the Refresh action.

    reject

    Indicates the user does not approve. In a business process, typically blocks the process from proceeding to the next step.

    See Approve.

    reply

    Indicates or completes a response to an email or a comment.

    remove

    Removes an object from a list or container but the object is not destroyed as a result of the action. Often requires one or more objects to be selected.

    Where appropriate, combine Remove with the object that will be removed (for example, Remove user, Remove role, Remove privileges). Contrast with Delete and Clear. See the Remove action.

    reset

    Reverts values back to their last saved state. The last saved state includes the values stored the last time the user clicked Apply. Does not close the dialog or window.

    See Restore defaults, Undo, Cancel, and the Reset action. Contrast with Restore.

    restore

    Brings a file back after deletion, corruption, or similar event.

    Contrast with Reset.

    restore all

    Completes a restore operation on all files or objects in a given system or container.

    Contrast with Restore.

    restore defaults

    Sets form values to the default settings.

    See Reset and Undo.

    run

    Sets form values to the default settings.

    Use instead of Execute.

    SS

    save

    Saves pending modifications made to a file or document. Does not close the window or panel.

    Contrast with Apply.

    save as

    Creates a new object based on the state of the object currently being viewed. The user names the new object and typically identifies its location.

    search

    Returns all objects (for example, files, names, or documents) within a defined set (for example, in a folder, directory, database, or the internet) that match some specified criteria.

    Contrast with Find and Filter.

    select

    Selects data from a table.

    select all

    Adds all objects in the view to the selection set or checks all Checkboxes.

    Contrast with Clear.

    send

    Transfers an email or other information to the recipient.

    show

    Reveals an object that was previously hidden.

    Context: Show descriptions. See Hide.

    sign up

    Creates a user account or registers a user in a system.

    Use instead of Register.

    start

    Deploy an app or service to its development or production environment so that it can be used.

    Use instead of Launch.

    sort

    Sorts a list or table column.

    Likely used only as a tooltip on an icon button. Can be used without 'Ascending' or 'Descending' only if the order can be provided to a screen reader in the code for accessibility.

    submit an idea

    Opens a separate window containing the IBM Cloud Ideas portal.

    Use only as link text on Support widget from the console menu bar.

    TT

    top

    Returns to the top of the page.

    Use instead of Back to top.

    UU

    undo

    Reverts to the state before the most recent changes made by the user. Repeated use successively reverts to prior states in reverse chronological order. Applies to changes in data and not to changes made to the view.

    Not all actions, such as Save, can be undone. See Redo, Reset, and Restore defaults.

    update

    Label for a button in a dialog or form for editing an object. The settings in the dialog are applied to the object when it is updated.

    See Edit.

    upload

    Transfers a file from a local system to a remote system.

    See Download.

    VV

    view details

    Presents additional information or properties for the object.