> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usebruno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Running Tests Manually

export const PremiumBadge = ({noLink}) => {
  const badge = <span style={{
    display: 'inline-flex',
    alignItems: 'center',
    gap: '0.25rem',
    padding: '0.25rem 0.5rem',
    fontSize: '0.75rem',
    fontWeight: '600',
    borderRadius: '0.5rem',
    backgroundColor: '#FCD34D',
    color: '#92400E',
    marginLeft: '0.5rem',
    lineHeight: '1.2'
  }}>
      PREMIUM
    </span>;
  if (noLink) {
    return badge;
  }
  return <a href="https://www.usebruno.com/pricing" target="_blank" rel="noopener noreferrer" style={{
    textDecoration: 'none'
  }}>
      {badge}
    </a>;
};

Running tests manually in Bruno allows you to quickly validate functionality and immediately view results. The most common example of this would be simply hitting an endpoint and seeing if it is working.

### Running a Single Test

The smallest unit of testing in Bruno is a single request. The request itself tests the functionality of any given endpoint. You can add additional logic to requests by using the `Tests` tab.

To manually trigger a single test:

1. Open a Collection
2. Select the Request that you would like to run
3. Click Enter or press the send icon
4. View the results in the `Tests` section of the response pane

### Running a Test Suite

Often times a Bruno Collection can represent a test suite of different actions or workflows of an API. You can use the Collection Runner to execute this entire suite, and also iterate through data using [data driven testing](/testing/automate-test/data-driven-testing).

Follow these steps to run your collection, view the results, and optionally download the test report as an HTML document.

1. Open the **Bruno** collection
2. Click on the **Run** option from the dropdown menu.

<img src="https://mintcdn.com/bruno-a6972042/K-YsMv4Crp6p2uFR/images/screenshots/get-started/bruno-basics/run_collection/run_collection.webp?fit=max&auto=format&n=K-YsMv4Crp6p2uFR&q=85&s=68fb4976a846c2f37c45f57d9c9490f5" alt="select-run.webp" width="2480" height="1046" data-path="images/screenshots/get-started/bruno-basics/run_collection/run_collection.webp" />

3. Click **Run Collection** to initiate the test.

<img src="https://mintcdn.com/bruno-a6972042/RIZZUa4STb33tpjE/images/screenshots/get-started/bruno-basics/run_collection/runner.webp?fit=max&auto=format&n=RIZZUa4STb33tpjE&q=85&s=e1237a15ec85c188490c5320cc0b43e7" alt="click-runner.webp" width="2596" height="1428" data-path="images/screenshots/get-started/bruno-basics/run_collection/runner.webp" />

4. Once the test run is complete, a test report will be automatically generated.

<img src="https://mintcdn.com/bruno-a6972042/KbpwWkeN627E4ypz/images/screenshots/testing/3-generate-test-report.webp?fit=max&auto=format&n=KbpwWkeN627E4ypz&q=85&s=42287fdfbf1693e0503e4e51c94d299c" alt="generate-test-report.webp" width="2472" height="836" data-path="images/screenshots/testing/3-generate-test-report.webp" />

### Download Test Report <PremiumBadge noLink />

After the test report is generated, you can download it as an HTML document (`report.html`).

1. Click the **Download Report** button to save the report.

<img src="https://mintcdn.com/bruno-a6972042/KbpwWkeN627E4ypz/images/screenshots/testing/4-details-test-reports.webp?fit=max&auto=format&n=KbpwWkeN627E4ypz&q=85&s=20764227dfcc0e164bca2044354adcad" alt="details-test-reports.webp" width="2472" height="1070" data-path="images/screenshots/testing/4-details-test-reports.webp" />

## Managing Request Execution

Bruno allows you to filter which requests to run in your collection using tags. You can add tags to your requests and then filter them during collection runs.

### Tag-Based Request Filtering

When running a collection in the Bruno app, you can filter requests by tags:

1. **Add tags to your requests**: Go to request settings and add tags to categorize your requests

<img src="https://mintcdn.com/bruno-a6972042/coTQlNiOALulIY4J/images/screenshots/collection-runner/1-add-tags.webp?fit=max&auto=format&n=coTQlNiOALulIY4J&q=85&s=c535fe3ec0e1af60c0cd0991d6cb4f07" alt="Add Tags to Requests" width="2472" height="1224" data-path="images/screenshots/collection-runner/1-add-tags.webp" />

2. **Go to Collection Runner**: Open the collection runner to start filtering requests
3. **Use tag filter options**: Use the tag filter options to include or exclude requests based on their tags
4. **Run filtered collection**: Only requests matching your tag criteria will be executed

<img src="https://mintcdn.com/bruno-a6972042/RIZZUa4STb33tpjE/images/screenshots/get-started/bruno-basics/run_collection/runner.webp?fit=max&auto=format&n=RIZZUa4STb33tpjE&q=85&s=e1237a15ec85c188490c5320cc0b43e7" alt="click-runner.webp" width="2596" height="1428" data-path="images/screenshots/get-started/bruno-basics/run_collection/runner.webp" />

#### Tag Filtering Options

* **Include tags**: Only run requests that have ALL of the specified tags
* **Exclude tags**: Skip requests that have ANY of the specified tags
* **Combined filtering**: Use both include and exclude filters together

Learn more about tag filtering in Bruno CLI in the [CLI tag filtering documentation](/bru-cli/runCollection#filtering-requests-with-tags).

### Reordering Request Execution

You can reorder, select, and deselect requests by enabling the **Configure requests to run** option in the Collection Runner. This feature allows you to:

* **Select specific requests** to execute while ignoring others
* **Reorder requests** to control the execution sequence
* **Customize test runs** without modifying the collection structure

By default, the Collection Runner executes all requests in the collection. When you enable request configuration, only the selected requests will be executed.

<img src="https://mintcdn.com/bruno-a6972042/RIZZUa4STb33tpjE/images/screenshots/get-started/bruno-basics/run_collection/runner.webp?fit=max&auto=format&n=RIZZUa4STb33tpjE&q=85&s=e1237a15ec85c188490c5320cc0b43e7" alt="click-runner.webp" width="2596" height="1428" data-path="images/screenshots/get-started/bruno-basics/run_collection/runner.webp" />

## View Test Report

Once the report is downloaded, you can open the `report.html` file in any web browser to review the detailed test results.

<img src="https://mintcdn.com/bruno-a6972042/KbpwWkeN627E4ypz/images/screenshots/testing/test-web-view.webp?fit=max&auto=format&n=KbpwWkeN627E4ypz&q=85&s=72b0faa7d81cc4193d95124ebc9e616f" alt="test-web-view.webp" width="2550" height="1510" data-path="images/screenshots/testing/test-web-view.webp" />
