---
id: api/commands/log
title: log | Cypress Documentation
description: Print a message to the Cypress Command Log.
section: api
source_path: docs/api/commands/log.mdx
version: 24a73f8a97175663aaffd3b016289fb2a523a4ea
updated_at: '2026-05-14T20:17:33.301Z'
---
# 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 [Learn about subject management](/llm/markdown/app/core-concepts/introduction-to-cypress.md#Subject-Management)

*   `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 [Learn about chaining commands](/llm/markdown/app/core-concepts/introduction-to-cypress.md#Chains-of-Commands)

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

### Assertions [Learn about assertions](/llm/markdown/app/core-concepts/introduction-to-cypress.md#Assertions)

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

### Timeouts [Learn about timeouts](/llm/markdown/app/core-concepts/introduction-to-cypress.md#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

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