> For the complete documentation index, see [llms.txt](https://gebra-it.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gebra-it.gitbook.io/wiki/client-api-reference/functions/cloudprint.md).

# cloudPrint

Sends a PDF to a printer, that is connected by the [BrixxboxCloudGateway](/wiki/how-tos/printing-in-lan.md). You can send a document to a cloudprinter by using [createReport](/wiki/client-api-reference/functions/createreport.md) as well.

## Parameters

A json object

## Example Usages

### Print an existing attachment

```javascript
app.cloudPrint({
  printerName: "HP LaserJet", //Printer NAme
  attachmentId: "1", //Attachment id
});
```

### Print an existing attachment with multiple copies

```javascript
app.cloudPrint({
  printerName: "HP LaserJet",
  attachmentId: "1",
  copies: 5, // 1 copy is the default. Needs "cloudPrint Gateway" installer Version 1.0.1 or newer
});
```

### Print a new created report without archiving

```javascript
let myReport = await app.createReport("myReport");
app.cloudPrint({
  printerName: "HP LaserJet", //Printer NAme
  blob: myReport, //The report blob object
});
```

### Return Values

The function itself does not have an explicit return statement, so it implicitly returns a promise. The function doesn't return any specific value on success and doesn't explicitly reject the promise on failure. Instead, it handles errors by displaying a message within the function.