AuthenticatedMemberName

Runtime verified

Syntax

AuthenticatedMemberName()  →  string

0 arguments — exactly

Parameters

This function takes no parameters.

Example

%%[
  VAR @memberName
  SET @memberName = AuthenticatedMemberName()
]%%
Business unit: %%=v(@memberName)=%%

Renders the business unit’s display name as shown in the Marketing Cloud UI — on the business unit tested, a nineteen-character label containing a space and a punctuation separator.

Because the value is free text an administrator can change, it is safer as something you show than as something you branch on. When it is shown, it is worth guarding against an unexpected empty result:

%%[
  VAR @memberName, @label
  SET @memberName = AuthenticatedMemberName()
  SET @label = IIf(Empty(@memberName), "this business unit", @memberName)
]%%
Sent from %%=v(@label)=%%

The name it hands back is the UI label, not the identifier your deployment configuration uses — see below.

Return value

string — a business unit display name.

The value domain is open: the name is free text chosen per business unit, so there is no closed set of sentinel values to test for. In particular there is no “not signed in” sentinel — an unauthenticated request gets an ordinary name back.

Behaviour

A public CloudPage request gets a value, not an empty result. An anonymous request to the published URL, carrying no Marketing Cloud session at all, rendered a name at HTTP 200. Empty() on the same value answered false and Length() gave 19.

The result is a value, not a page-terminating call. It compared against the empty string, rendered inline without a variable, and rendered unchanged nested inside a Concat between two surrounding characters. Every line after the call still rendered.

The value is stable inside one render. Three separate calls in the same request — an assignment, an inline call and a nested call — produced identical output.

It is free text, not an identifier. IndexOf found a space partway through the value, and found no dot, no @ and no underscore anywhere. IsEmailAddress() rejected it. So unlike the email-shaped Authenticated* siblings and unlike the digits-only ID siblings, this value is human-readable prose with internal whitespace — quote or escape it like any other free text before using it as a key.

It is the business unit’s display name, not its configuration name

The page under test was published on a child business unit, and what came back was that business unit’s label as shown in the Marketing Cloud UI.

That label is not the name your tooling uses. Compared in the same render against the business unit name held in the account’s deployment configuration, a direct equality comparison answered no, and IndexOf answered 0 — its not-found result — in both directions. The two forms are recognisably the same business unit written differently: the UI label separates its words with spaces and punctuation where the configuration name uses underscores. A page that string-matches this value against a configured name will therefore silently never match.

If you need to branch per business unit, match on AuthenticatedMemberID instead — a MID is stable and exact, where a display name is free text an administrator can edit at any time.

It is not a person

AuthenticatedEmployeeUserName, called in the same render, returned a completely different string — 39 characters against this function’s 19, email-shaped where this one has no @ at all — and IndexOf answered 0 in both directions, so neither value occurs inside the other. Despite the shared Authenticated prefix, one names a business unit and the other names a login.

Do not use it as an authentication check

Because a value always comes back, a page cannot infer from a non-empty result that its visitor is a signed-in Marketing Cloud user. Content gated on that check would be open to everyone. Use a real authentication mechanism for the gate and treat this function as context information only.

Show test script

%%[
  VAR @b, @amn, @aeun, @buName
  SET @b = RequestParameter("b")
  SET @buName = "Your_Configured_BU_Name"

  /* known-good control: renders on every request, so a run of HTTP 422s
     can be told apart from a deploy that failed to compile */
  OutputLine(Concat("CTRL=[", Uppercase("ok"), "]"))

  OutputLine(Concat("--- AMN start ---"))

  /* a plain anonymous request still produces a value */
  SET @amn = AuthenticatedMemberName()
  OutputLine(Concat("AMN=[", @amn, "]"))

  /* confirmed with a second function rather than read off empty brackets */
  OutputLine(Concat("AMN_EMPTY=[", IIf(Empty(@amn), "empty", "not-empty"), "]"))
  OutputLine(Concat("AMN_LEN=[", Length(Concat(@amn, "")), "]"))

  /* the value is usable inline, nested and in a comparison */
  OutputLine(Concat("AMN_DIRECT=[", AuthenticatedMemberName(), "]"))
  OutputLine(Concat("AMN_IN_CONCAT=[", Concat("<", AuthenticatedMemberName(), ">"), "]"))
  OutputLine(Concat("AMN_CMP=[", IIf(@amn == "", "eq-emptystring", "ne-emptystring"), "]"))
  OutputLine(Concat("--- AMN done ---"))

  /* what the value looks like, which name it is, and how it relates to the
     username sibling read in the very same render */
  IF @b == "shape" THEN
    OutputLine(Concat("--- shape start ---"))
    OutputLine(Concat("DOT_POS=[", IndexOf(@amn, "."), "]"))
    OutputLine(Concat("SPACE_POS=[", IndexOf(@amn, " "), "]"))
    OutputLine(Concat("AT_POS=[", IndexOf(@amn, "@"), "]"))
    OutputLine(Concat("USCORE_POS=[", IndexOf(@amn, "_"), "]"))
    OutputLine(Concat("IS_EMAIL=[", IIf(IsEmailAddress(@amn), "yes", "no"), "]"))
    OutputLine(Concat("BUNAME_MATCH=[", IIf(@amn == @buName, "yes", "no"), "]"))
    OutputLine(Concat("BUNAME_IN_AMN=[", IndexOf(@amn, @buName), "]"))
    OutputLine(Concat("AMN_IN_BUNAME=[", IndexOf(@buName, @amn), "]"))
    SET @aeun = AuthenticatedEmployeeUserName()
    OutputLine(Concat("AEUN_LEN=[", Length(Concat(@aeun, "")), "]"))
    OutputLine(Concat("SAME_AS_AEUN=[", IIf(@amn == @aeun, "identical", "different"), "]"))
    OutputLine(Concat("AMN_IN_AEUN=[", IndexOf(@aeun, @amn), "]"))
    OutputLine(Concat("AEUN_IN_AMN=[", IndexOf(@amn, @aeun), "]"))
    OutputLine(Concat("--- shape done ---"))
  ENDIF

  /* argument counts the signature does not allow: each aborts its branch */
  IF @b == "ar1" THEN
    OutputLine(Concat("--- ar1 start ---"))
    OutputLine(Concat("AMN1=[", AuthenticatedMemberName("x"), "]"))
    OutputLine(Concat("--- ar1 done ---"))
  ENDIF

  IF @b == "ar2" THEN
    OutputLine(Concat("--- ar2 start ---"))
    OutputLine(Concat("AMN2=[", AuthenticatedMemberName("x", "y"), "]"))
    OutputLine(Concat("--- ar2 done ---"))
  ENDIF
]%%

OutputLine needs Concat

Every marker and label in the test script goes through Concat(...), including single-argument ones. A bare string literal passed to OutputLine renders an empty line while the page still returns HTTP 200, so the marker silently vanishes.

Availability

Platform	Available
Marketing Cloud Engagement	Yes
Marketing Cloud Next	No

The official reference scopes this function to microsites using sender authenticated redirection and states it is not for CloudPages. That authenticated path was not exercised here — a public CloudPage cannot supply such a session — so everything on this page describes the unauthenticated CloudPage context only, and no claim is made about whose session the returned name would reflect on a microsite.