# Element Properties

Below is a list of properties that you can set for the plugin's element, most of which relate to Pipe's own recorder properties. Note that some of the properties apply to Pipe's desktop recorder only while some apply only to Pipe's native recorders on mobile. Please consult Pipe's [documentation](https://addpipe.com/docs#v2-edit-js) in the first instance if you have any questions about the meaning or use of these properties. To facilitate this, the table below includes a column showing Pipe’s property names for reference.

| Name                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Pipe Property Name |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| Environment Id                                | Mandatory. This is the ID of the Pipe environment you want your recording to belong to. This is set to 1 by default and you only need to change this if you set up and want to use other environments. It can be changed to any other environment id that you have created. You can get the environment from the Edit your [Pipe environment page](https://addpipe.com/env_edit). Note: there is no error handling by the plugin in case an unknown or incorrect value is specified.                                                                                                                                                                                                                                                            | eid                |
| Unique Instance Id                            | Mandatory. Enter a number here to identify each Pipe Recorder element on your page. If you have only one recorder on the page then you can just enter 1. If you have more than one recorder then you are responsible for making sure that each recorder has a unique number in this field. There is no error handling in place to test this but if two instances have the same Id, it is likely that they will conflict with each other. If you're placing recorders in a repeating group then consider using the current cell#s index in this field. In the unlikely event that you have recorders in more than one repeating group another number to identify the repeating group should be added to the current cell#s index for uniqueness. | N/A                |
| Skip initial screen                           | When set to true, the initial screen with the \[Record Video] or \[Record Audio] text will not be shown, skipping directly to the recording screen. Defaults to false.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | sis                |
| Maximum recording time                        | The maximum recording time in seconds. Limiting the actual recording works only on desktop devices but you can also configure your account on the Pipe website to automatically trim recordings to the value set here, in which case recordings from mobile will be trimmed down to size. It is probably a good idea to inform your users if you do this. The default value is 120.                                                                                                                                                                                                                                                                                                                                                             | mrt                |
| Auto-save recordings                          | When set to true, recordings will be automatically saved to Pipe (or to your Amazon s3 storage if you have set Pipe to save there). When set to false, the recordings won't be automatically saved - instead, a Save icon will be shown in the recorder and the user will have to click on it. Turning auto-save off may be useful to reduce the use of storage for unwanted recordings.                                                                                                                                                                                                                                                                                                                                                        | asv                |
| Allow desktop uploads                         | When set to true, the recorder will allow users to directly upload pre-recorded videos or audio files on desktop. The default value is false.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | dup                |
| Audio only                                    | When set to true, the recorder will record audio only. The default value is false.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | ao                 |
| Allow desktop screen recording                | Desktop only. When set to true, the recorder will allow the user to record their screen. Defaults to false.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | srec               |
| Disallow pre-recorded video uploads on mobile | When set to true, the native mobile client will hide the options that allow the user to select an existing recording from the photo/video library or from other services like iCloud Drive on iOS, Dropbox or Files on Android. Defaults to false.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | dpv                |
| Mirro video                                   | When set to yes, the desktop recording client will flip the video image horizontally during recording. During playback the image will not be flipped. The image in the final recording will not be flipped.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | mv                 |
| Show menu                                     | Determines whether or not to show Pipe's native menu controls on the desktop recorder. The default value is yes. Change to no to hide the menu and use your own controls bound to the relevant element actions. Set to no with caution because a) you're then responsible for controlling the recorder with Bubble events and actions (see section x for more details); b) this affects only the desktop recorder (which can be enabled for Android but not for iOS).                                                                                                                                                                                                                                                                           |                    |
| Quality URL                                   | Mandatory. This is the path to the quality profile. Set to one of the following: avq/240p.xml, avq/300p.xml, avq/480p.xml and avq/720p.xml or it can be the path to your custom quality profile (affects only the quality on desktop devices). Note: there is no error handling by the plugin in case an unknown or incorrect value is specified. Defaults to avq/300p.xml                                                                                                                                                                                                                                                                                                                                                                      | qualityurl         |
|                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                    |
| Background colour                             | The background colour of the recorder. Leave blank for default Pipe skin.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | bgCol              |
| Corner roundness                              | Controls the corner roundness of all four corners of the recorder                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | cornerradius       |
| Menu colour                                   | Controls the colour of the control menu of the recorder. Leave blank to use default Pipe colours. IMPORTANT: If you have multiple recorders on a page, you should set this colour to be the same across all of them. Otherwise, whilst the colour is properly set individually to begin with, due to a known issue, hovering over any of the buttons will cause the colours to be overwritten with the colour set on the last recorder found on the page. This appears to be a limitation either with the Bubble plugin framework or with Pipe's own code.                                                                                                                                                                                      | menuCol            |
| Button colour                                 | <p>Controls the default colour of the buttons and other clickable Pipe recorder UI elements. Leave blank to use default Pipe colours. </p><p>IMPORTANT: If you have multiple recorders on a page, you should set this colour to be the same across all of them. Otherwise, whilst the colour is properly set individually to begin with, due to a known issue, hovering over any of the buttons will cause the colours to be overwritten with the colour set on the last recorder found on the page. This appears to be a limitation either with the Bubble plugin framework or with Pipe's own code.</p>                                                                                                                                       | normalCol          |
| Hover colour                                  | Controls the mouse-over colour of the buttons and other clickable Pipe recorder UI elements. Leave blank to use default Pipe colours. IMPORTANT: If you have multiple recorders on a page, you should set this colour to be the same across all of them. Otherwise, whilst the colour is properly set individually to begin with, due to a known issue, hovering over any of the buttons will cause the colours to be overwritten with the colour set on the last recorder found on the page. This appears to be a limitation either with the Bubble plugin framework or with Pipe's own code.                                                                                                                                                  | overCol            |


---

# 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://louisadekoya.gitbook.io/pipe-video-and-audio-recorder-plugin-for-bubble/element-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.