# Mobile Credential-Related Properties

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

## `acs_credential` Properties

These properties are applicable to [guest](/latest/device-and-system-integration-guides/assa-abloy-visionline-access-control-system/configuring-visionline-mobile-credentials.md#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="https://docs.seam.co/latest/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>

***

## `acs_credential.visionline_metadata` Properties

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.seam.co/latest/device-and-system-integration-guides/assa-abloy-visionline-access-control-system/mobile-credential-related-properties.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.