All docs
Feature reference Build tests • 2 min reference

Extract a value from email

Email value extraction reads a matching email and pulls out a code or other value for a later browser step.

This reference explains the term, its purpose, a practical example, common use cases, where it appears in Rima, and the closest product visual.
Adding a validation in the Rima extension
Validations define the result that must be true for a test to pass.

Definition

Email value extraction reads a matching email and pulls out a code or other value for a later browser step.

What it is for

It completes email-based flows where the user must copy information from an inbox back into the website.

How it works

  • The step waits for a matching email to the generated inbox, then pulls the value using surrounding words (before/after text) or a regular expression with a capture group.
  • Paste a sample email and sample value and Rima builds the matching settings for you.
  • The extracted value fills the input step; per-character mode types one character into each OTP box using a box selector and start index.

Example

Read the six-digit verification code after “code is”, save it, and type one character into each OTP box.

Common use cases

  • One-time passwords.
  • PIN verification.
  • Order or booking references.
  • Temporary login codes.

Where to find it

Edit an input step, choose From Email, then configure the message, source, value type, surrounding words or regular expression, and optional per-character boxes.

Limitations, requirements, and permissions

  • Requires a random-email step in the test to create the inbox.
  • The sample builder needs both a sample email and a sample value, and the value must appear in the sample.

Related features and guides

Ready to try it yourself?

Create your free account, record your first flow, add a validation, and let Rima run it on a schedule for you.

Start free trial