> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Mobile Credential-Related Properties

> Learn about credential properties that you should use when creating mobile credentials.

When issuing a guest mobile credential, you can use the following relevant properties:

## `acs_credential` Properties

These properties are applicable to [guest](/device-and-system-integration-guides/assa-abloy-visionline-access-control-system/configuring-visionline-mobile-credentials/index#issuing-guest-mobile-credentials) credentials for the Visionline ACS.

<table>
  <thead>
    <tr>
      <th width="260">Property</th>
      <th width="116">Type</th>
      <th width="290">Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <code>is\_multi\_phone\_sync\_credential</code>
      </td>

      <td>
        Boolean

        <br />

        <em>Optional</em>
      </td>

      <td>
        Indicates whether the credential is a{' '}

        <a href="/capability-guides/mobile-access/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials">
          multi-phone sync credential
        </a>

        .<br />
        When creating a Seam mobile key for a Visionline ACS, you must set this
        property to <code>true</code>.
      </td>
    </tr>

    <tr>
      <td>
        <code>allowed\_acs\_entrance\_ids</code>
      </td>

      <td>
        Array of strings <em>Optional</em>
      </td>

      <td>
        List of ACS entrance IDs to which you want to grant the specified ACS
        user access.{' '}
      </td>
    </tr>

    <tr>
      <td>
        <code>starts\_at</code>
      </td>

      <td>
        <a href="https://www.iso.org/iso-8601-date-and-time-format.html">
          ISO 8601
        </a>

        {' '}

        format

        <br />

        <em>Optional</em>
      </td>

      <td>Starting timestamp for credential activation.</td>
    </tr>

    <tr>
      <td>
        <code>ends\_at</code>
      </td>

      <td>
        <a href="https://www.iso.org/iso-8601-date-and-time-format.html">
          ISO 8601
        </a>

        {' '}

        format

        <br />

        <em>Optional</em>
      </td>

      <td>Ending timestamp for credential expiration.</td>
    </tr>
  </tbody>
</table>

***

<h2 id="acs_credentialvisionline_metadata-properties">
  `acs_credential.visionline_metadata` Properties
</h2>

Use the `credential.visionline_metadata` object to include brand-specific data for your Visionline credentials.

<table>
  <thead>
    <tr>
      <th width="260">Property</th>
      <th width="116">Type</th>
      <th width="290">Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <code>card\_function\_type</code>
      </td>

      <td>
        Enum

        <br />

        <em>Optional</em>
      </td>

      <td>
        <code>guest</code>
      </td>
    </tr>

    <tr>
      <td>
        <code>cardFormat</code>
      </td>

      <td>
        Enum

        <br />

        <em>Required</em>
      </td>

      <td>
        <p>
          <code>rfid48</code> | <code>TLCode</code>
        </p>

        <ul>
          <li>
            <code>rfid48</code>: A low-capacity card. It can store up to 33
            consecutive guest rooms, 28 common rooms, and 7 additional rooms.
          </li>

          <li>
            <code>TLCode</code>: A high capacity RFID card (for card types
            needing more than 48 bytes).
          </li>
        </ul>

        <p>
          For guest cards, generally use <code>rfid48</code>.
        </p>

        <p>
          For guest advanced cards, which need a higher capacity format, use{' '}
          <code>TLCode</code>.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <code>label</code>
      </td>

      <td>
        String

        <br />

        <em>Optional</em>
      </td>

      <td>
        "Label" field data for mobile credentials. This field may contain plain
        text, as well as predefined placeholders. The placeholders are
        surrounded by percent signs (<code>%</code>).

        <br />

        See{' '}

        <a href="#label-placeholders">
          Label Placeholders
        </a>

        .
      </td>
    </tr>

    <tr>
      <td>
        <code>override</code>
      </td>

      <td>
        Boolean

        <br />

        <em>Optional</em>
      </td>

      <td>
        Indicates whether this guest credential invalidates any
        previously-issued credentials for overlapping entrances.

        <br />

        Applicable only to guest credentials.
      </td>
    </tr>

    <tr>
      <td>
        <code>joiner\_acs\_credential\_ids</code>
      </td>

      <td>
        Array of strings <em>Optional</em>
      </td>

      <td>
        List of credential IDs with which the current guest credential shares
        entrance access. When <code>override\_previous\_credentials</code> is{' '}
        <code>false</code>, <code>joiner\_acs\_credential\_ids</code> becomes a
        mandatory field.

        <br />

        Applicable only to guest credentials.
      </td>
    </tr>

    <tr>
      <td>
        <code>assa\_abloy\_credential\_service\_mobile\_endpoint\_id</code>
      </td>

      <td>
        String

        <br />

        <em>Optional</em>
      </td>

      <td>
        ID of the ASSA ABLOY Credential Service mobile endpoint associated with
        the credential.
      </td>
    </tr>

    <tr>
      <td>
        <code>is\_valid</code>
      </td>

      <td>
        Boolean

        <br />

        <em>Optional</em>
      </td>

      <td>Indicates whether the credential is currently valid.</td>
    </tr>
  </tbody>
</table>

***

## Label Placeholders

The `label` field provides "label" field data for mobile credentials. This field may contain plain text, as well as predefined placeholders. The placeholders are surrounded by percent signs (`%`). Visionline replaces these placeholders with the actual values before issuing mobile keys. The final text is truncated to 32 characters. The valid placeholders are as follows:

* `%ROOMNUM%`: Replaced with main guest room number or name.
* `%ROOMLIST%`: Replaced with comma-separated list of guest rooms.
* `%ROOMRANGE%`: Replaced with hyphen-separated room range. Alternately, if some rooms do not fit into any range, then they are added as a comma-separated list.
* `%SITENAME%`: Name of the property.
* `%CARDNUM%`: Credential ID.
* `%UUID%`: BLE UUID.
* `%USERID%`: Value passed in the UI field.