> For the complete documentation index, see [llms.txt](https://alix-lahuec.gitbook.io/zotero-roam/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alix-lahuec.gitbook.io/zotero-roam/v0.5/customization/other/copy_settings.md).

# Copying an item's reference

## override\_quickcopy

| Setting name         | Possible values                                  |
| -------------------- | ------------------------------------------------ |
| `override_quickcopy` | `altKey` or `ctrlKey` or `metaKey` or `shiftKey` |

If the specified key is pressed when selecting an item from Search results, the extension will always render the item's data - even if Quick Copy is enabled.&#x20;

You can use this to occasionally override Quick Copy.

```javascript
zoteroRoam_settings = {
    // Your dataRequests object should be here :
    dataRequests: {
        apikey: 'XXXXXXXXXXXXXXXX',
        dataURI: 'users/1234567/items',
        params: 'limit=100'
    },
    
    override_quickcopy: 'shiftKey'
}
```

## always\_copy

| Setting name  | Possible values             |
| ------------- | --------------------------- |
| `always_copy` | `true` or `false` (default) |

```javascript
zoteroRoam_settings = {
    // Your dataRequests object should be here :
    dataRequests: {
        apikey: 'XXXXXXXXXXXXXXXX',
        dataURI: 'users/1234567/items',
        params: 'limit=100'
    },
    
    always_copy: true
}
```

If set to `true`, the extension will always copy the selected item's reference to the clipboard - even if Quick Copy is disabled. The format used to copy the reference will be the one specified by `quick_copy_format`.

## quick\_copy\_format

| Setting name        | Possible values                                                                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `quick_copy_format` | <p>One of :<br><code>citekey</code> (default)<br><code>tag</code><br><code>pageref</code><br><code>citation</code></p> |

Here are the different outputs available :

* `citekey` (default) : @eghbalRoadsBridgesUnseen2016
* `tag` : #\[\[@eghbalRoadsBridgesUnseen2016]]
* `pageref` : \[\[@eghbalRoadsBridgesUnseen2016]]
* `citation` : \[Eghbal (2016)]\(\[\[@eghbalRoadsBridgesUnseen2016]])

```javascript
zoteroRoam_settings = {
    // Your dataRequests object should be here :
    dataRequests: {
        apikey: 'XXXXXXXXXXXXXXXX',
        dataURI: 'users/1234567/items',
        params: 'limit=100'
    },
    
    quick_copy_format: 'citation'
}
```
