> For the complete documentation index, see [llms.txt](https://docs.hello-lisa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hello-lisa.com/developers/guides/integration-guide/entrypoints/query-parameter-v1.md).

# Query Parameter (v1)

{% hint style="info" %}
The parameters outlined on this page are applicable exclusively to LiSA Player version 1.
{% endhint %}

<table><thead><tr><th width="192" valign="top">Name</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><code>replay_time</code></td><td><p>The <code>replay_time</code> parameter specifies the starting point for a show recording. By providing a numeric value, you can determine the exact time, in seconds, at which the playback should begin.</p><p></p><p><strong>Accepted Value:</strong></p><ul><li>Any non-negative numeric value representing the desired start time in seconds.<br>(e.g., <code>0</code> for the beginning of the recording, <code>60</code> for one minute into the recording, etc.)</li></ul></td></tr><tr><td valign="top"><code>ui_close_icon</code></td><td><p>The <code>ui_close_icon</code> parameter specifies space reservation in the player's header for an external UI control, such as a close button. This ensures that external UI elements do not overlap with the player's built-in controls.</p><p></p><p><strong>Value Pattern:</strong> <code>(left|right)(:width)?(:height)?</code></p><ul><li><strong><code>left</code> or <code>right</code>:</strong> Specifies the side of the viewport where the space is reserved.</li><li><strong><code>:width</code> (optional):</strong> The width of the reserved space, specified as a valid CSS length (e.g., <code>32px</code>, <code>2em</code>). If omitted, the default width is <code>32px</code>.</li><li><strong><code>:height</code> (optional):</strong> The height of the reserved space, specified as a valid CSS length. If omitted, the default height matches the width.</li></ul><p><strong>Default Behavior:</strong></p><ul><li>If only the side (<code>left</code> or <code>right</code>) is provided, a default space of <code>32x32px</code> is reserved.</li><li>If one additional value is provided, it applies to both width and height.</li><li>If both width and height are provided, they are applied independently.</li></ul><p><strong>Example Usage:</strong></p><p>Default size on the right — Reserves <code>32x32px</code> in the top-right corner</p><pre><code>ui_close_icon=right
</code></pre><p>Custom size on the right — Reserves <code>42x42px</code> in the top-right corner</p><pre><code>ui_close_icon=right:42px
</code></pre><p>Custom width and height on the left — Reserves <code>50px</code> width and <code>40px</code> height in the top-left corner.</p><pre><code>ui_close_icon=left:50px:40px
</code></pre></td></tr><tr><td valign="top"><code>url_params</code></td><td><p>The <code>url_params</code> parameter allows you to append custom query parameters to URLs exposed by the LiSA Player, such as those used for social sharing or add-to-calendar options. This enables you to include additional data or tracking parameters in a structured and URL-safe manner.</p><p></p><p><strong>Usage Guidelines:</strong></p><ul><li>Provide the query parameters in URL-encoded form.</li><li>Use standard query string syntax: <code>key1=value1&#x26;key2=value2</code>.</li></ul><p><strong>Example Usage:</strong></p><p>To append <code>utm_source</code> and <code>utm_campaign</code> parameters:</p><pre><code>url_params=utm_source%3Dsocial%26utm_campaign%3Devent_launch
</code></pre><p>To append a custom parameter:</p><pre><code>url_params=ref_id%3D12345
</code></pre><p>This parameter allows you to extend the functionality of URLs for tracking or customization, ensuring seamless integration with your workflows and analytics tools.</p></td></tr></tbody></table>
