---
id: api/commands/log
title: cy.log()
description: Print a message to the Cypress Command Log.
section: api
source_path: docs/api/commands/log.mdx
version: 066c46e056f0f322a0670d2d3aa4e6adaebfe717
updated_at: '2026-09-10T13:30:12.426Z'
---
# log

Print a message to the Cypress Command Log.

## Syntax

```
cy.log(message)
cy.log(message, args...)
```

### Usage

**Correct Usage**

```
cy.log('created new user')
```

### Arguments

**message _(String)_**

Message to be printed to Cypress Command Log. Accepts a Markdown formatted message.

**args...**

Additional arguments to be printed to the Cypress Command Log. There is no limit to the number of arguments.

### Yields

*   `cy.log()` yields `null`.

## Examples

### Message

#### Print a message to the Command Log.

```
cy.click('Login')
cy.log('Login successful')
```

### Args

#### Print a message with arguments to the Command Log.

```
cy.log('events triggered', events)
```

## Rules

### Requirements

*   `cy.log()` requires being chained off of `cy`.

### Assertions

*   `cy.log()` cannot have any assertions chained.

### Timeouts

*   `cy.log()` cannot time out.

## Command Log

**_Print messages with arguments to the Command Log._**

```
cy.log('log out any message we want here')
cy.log('another message', ['one', 'two', 'three'])
```

The commands above will display in the Command Log as:

When clicking on `log` within the command log, the console outputs the following:

## See also

*   [`Cypress.log`](/llm/markdown/api/cypress-api/cypress-log.md)
*   [`cy.task()`](/llm/markdown/api/commands/task.md)