Skip to main content
CYPEX Documentation
    Support
    v2.0.0 Latest stable release View changelog ->
    1. CYPEX — PostgreSQL Application Platform
    2. /
    3. Element Dictionary
    4. /
    5. Various
    6. /
    7. External Link Field
    Various Referencegenerated

    External Link Field

    Display a link to an external URL

    Technical id
    default_external_link_field
    Default size
    1 × 1 cells
    Translation keys
    label

    An interactive underlined text hyperlink that routes the user to a targeted external web address upon click. It can optionally be visually transformed to look exactly like a standard platform action button.

    When to use

    • Navigating users away from the current platform application to external domains, websites, or foreign reference pages.
    • Providing links to external support portals, external documentation, or static downloadable web assets.

    Examples

    • An underlined text link pointing out to a vendor’s external terms of service dashboard.
    • A button-styled link redirecting administrators directly to an external server management console.

    Avoid

    • Navigating to another page inside the exact same app workspace — use internal link buttons or routing options instead to preserve application state.
    • Omiting required transfer protocols (such as http:// or https://) inside the Destination property string, which causes broken or dead paths.

    Use instead

    • Internal Link Button — The target destination resides within the current platform environment page ecosystem.

    Editor properties

    Configure these in the Application Designer property panel. Group headings mirror the editor where possible. Data Source is where the element gets its rows or field binding (a view/query, a connector operation, or a parent form field). References appear only for view-backed sources and map foreign-key ID columns to readable labels from another view.

    Configuration
    LinkrequiredCustom expression
    The target external web address. Can be a hardcoded text URL or dynamically defined via expressions. Must include an explicit protocol prefix (e.g. http:// or https://).
    Example https://example.com/docs
    Default: none
    Display
    ColoroptionalOne of: primary, secondary, success, error, warning, info, default, lighter, disabled, white, black (or not set)
    Sets the visual text palette variant mapping using static platform colors or custom string expressions.
    Choices
    • primary — Theme default branding blue color (#007bff).
    • secondary — Muted branding slate gray color (#6c757d).
    • success — Standard transactional green color (#28a745).
    • error — Severe action warning red color (#dc3545).
    • warning — Cautionary yellow color (#ffc107).
    • info — Informing teal/light blue color (#17a2b8).
    • default — Dark charcoal text color (#343a40).
    • lighter
    • disabled — Non-interactive gray color (#adb5bd).
    • white — Plain white color (#ffffff).
    • black — Plain black color (#000000).
    Default: none
    Is ButtonoptionalYes / no
    A boolean switch that alters the structural theme styling, rendering the text link inside a standard colored action button element box frame.
    Default: none
    DisabledoptionalCustom expression (yes/no)
    When true, the control cannot be edited.
    Example false
    Default: none

    Sizing

    • Minimum size: 1 × 1 grid cells (width × height).
    • Default size when dropped on a page: 1 × 1.

    Translatable labels

    • label — The visible anchor text string representing the link that users click.

    Accessibility

    Renders as a native anchor HTML element ( tag) containing appropriate keyboard focus indicators and standard screen reader hyperlink markers.

    Where you can place it

    Drag this element into one of these containers:

    1
2
3
4
5

    {
  "config": {
    "link": "@@expression:'value'"
  }
}

     1
 2
 3
 4
 5
 6
 7
 8
 9
10

    {
  "config": {
    "link": "@@expression:'value'",
    "disabled": "@@expression:true",
    "isButton": false,
    "icon": "icon",
    "color": "primary",
    "variant": "outlined"
  }
}

    Ready-made setups

    Configuring a link field to visually present itself as a bright primary button that routes to a secure documentation hub address.

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

    {
  "config": {
    "configuration": {
      "link": "https://support.example.com"
    },
    "display": {
      "color": "primary",
      "isButton": true
    }
  }
}