SUMIF function

PRO BASIC

The SUMIF function in Jspreadsheet Formulas Pro is a great tool for adding together certain numbers in a range of cells based on a given condition. For example, you can use it to add only the cells that contain numbers above a certain value or only those that contain a specific text. It's like a regular sum function, but with an added filter or condition that the cells must meet for them to be included in the sum.

Documentation

Returns the sum of a range of cells that meet a specified criteria.

Syntax

SUMIF(range, criteria, [sum_range])

Parameter	Description
`range`	The range of cells to evaluate.
`criteria`	The criteria used to determine which cells to add.
`sum_range`	Optional. The range of cells to add together. If omitted, the cells in 'range' are used.

Behavior

The SUMIF function is used to add up cells that meet a particular condition. It has three arguments: range, criteria, and sum_range. The 'range' is the group of cells to apply the criteria to, 'criteria' is the condition that must be met, and 'sum_range' is the cells to sum.

Here is how SUMIF handles various types of data:

Empty cells: SUMIF ignores empty cells in the sum_range.
Text: If the criteria is a text string, SUMIF matches cells that contain the exact text string.
Booleans: SUMIF can use boolean criteria to match cells. For example, =SUMIF(A1:A10, TRUE, B1:B10) would sum the cells in B1:B10 where the corresponding cell in A1:A10 is TRUE.
Errors: If any cell in the sum_range contains an error, SUMIF returns an error. If any cell in the range that is being evaluated has an error, that cell is ignored.

Common Errors

Error	Description
#VALUE!	This error is displayed when the given criteria is a text string but is not enclosed in quotation marks.

Best practices

Always make sure to enclose text string criteria in quotation marks to avoid the #VALUE! error.

Be careful with your cell references in the range and sum_range arguments to avoid summing the wrong cells.

If you're using a cell reference for your criteria, ensure that the cell is not empty to avoid the #N/A error.

If you have a large dataset, consider using the SUMIFS function instead, as it can handle multiple criteria and can improve performance.

Usage

A few examples using the SUMIF function.

SUMIF(A2:A6, ">10") returns the sum of all values in cells A2 through A6 that are greater than 10  
SUMIF(A2:A6, "apples", B2:B6) returns the sum of all values in cells B2 through B6 where the corresponding cell in A2 through A6 contains the text "apples"  
SUMIF(D2:D6, "=green", E2:E6) returns the sum of all values in cells E2 through E6 where the corresponding cell in D2 through D6 contains the text "green"

Interactive Spreadsheet Demo

<html>
<script src="https://jspreadsheet.com/v11/jspreadsheet.js"></script>
<script src="https://jsuites.net/v5/jsuites.js"></script>
<link rel="stylesheet" href="https://jsuites.net/v5/jsuites.css" type="text/css" />
<link rel="stylesheet" href="https://jspreadsheet.com/v11/jspreadsheet.css" type="text/css" />

<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Material+Icons" />
<script src="https://cdn.jsdelivr.net/npm/@jspreadsheet/formula-pro/dist/index.min.js"></script>

<div id="spreadsheet"></div>

<script>
// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('YjM5OWJjMTc4ZGY2YzQ2NmRiOGM1MmRiOTE3MmQwOWZiNzE0NDdjNDRmZGQyNDVkOWYxYWY1ZTA2MTIwOGUyMzY5NzUwY2VjY2UzNzU4Y2E0YzBkMGZiNDcyNzI2MzI1YzRlOWE0NWYwNjg0ZjRkODIwZWU1NjUzYTU5ZmYxNzMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOVFEyTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

// Create a new spreadsheet
jspreadsheet(document.getElementById('spreadsheet'), {
  worksheets: [{
    data: [
    [
        "Product",
        "Quantity",
        "Price"
    ],
    [
        "Apples",
        10,
        2.5
    ],
    [
        "Bananas",
        15,
        1.2
    ],
    [
        "Apples",
        8,
        2.5
    ],
    [
        "Oranges",
        12,
        3.0
    ],
    [
        "Total Apples Quantity:",
        "=SUMIF(A2:A5,\"Apples\",B2:B5)"
    ],
    [
        "Revenue from Apples:",
        "=SUMIF(A2:A5,\"Apples\",C2:C5)*SUMIF(A2:A5,\"Apples\",B2:B5)"
    ]
]
  }]
});
</script>
</html>

import React, { useRef } from "react";
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/react";
import formula from "@jspreadsheet/formula-pro";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";

// Set license
jspreadsheet.setLicense('YjM5OWJjMTc4ZGY2YzQ2NmRiOGM1MmRiOTE3MmQwOWZiNzE0NDdjNDRmZGQyNDVkOWYxYWY1ZTA2MTIwOGUyMzY5NzUwY2VjY2UzNzU4Y2E0YzBkMGZiNDcyNzI2MzI1YzRlOWE0NWYwNjg0ZjRkODIwZWU1NjUzYTU5ZmYxNzMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOVFEyTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

export default function App() {
    // Spreadsheet array of worksheets
    const spreadsheet = useRef();

    // Worksheet data
    const data = [
    [
        "Product",
        "Quantity",
        "Price"
    ],
    [
        "Apples",
        10,
        2.5
    ],
    [
        "Bananas",
        15,
        1.2
    ],
    [
        "Apples",
        8,
        2.5
    ],
    [
        "Oranges",
        12,
        3.0
    ],
    [
        "Total Apples Quantity:",
        "=SUMIF(A2:A5,\"Apples\",B2:B5)"
    ],
    [
        "Revenue from Apples:",
        "=SUMIF(A2:A5,\"Apples\",C2:C5)*SUMIF(A2:A5,\"Apples\",B2:B5)"
    ]
];

    // Render component
    return (
        <Spreadsheet ref={spreadsheet}>
            <Worksheet data={data} />
        </Spreadsheet>
    );
}

<template>
    <Spreadsheet ref="spreadsheet">
        <Worksheet :data="data" />
    </Spreadsheet>
</template>

<script>
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/vue";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";
import formula from "@jspreadsheet/formula-pro";

// Set license
jspreadsheet.setLicense('YjM5OWJjMTc4ZGY2YzQ2NmRiOGM1MmRiOTE3MmQwOWZiNzE0NDdjNDRmZGQyNDVkOWYxYWY1ZTA2MTIwOGUyMzY5NzUwY2VjY2UzNzU4Y2E0YzBkMGZiNDcyNzI2MzI1YzRlOWE0NWYwNjg0ZjRkODIwZWU1NjUzYTU5ZmYxNzMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOVFEyTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

export default {
    components: {
        Spreadsheet,
        Worksheet,
    },
    data() {
        // Worksheet data
        const data = [
    [
        "Product",
        "Quantity",
        "Price"
    ],
    [
        "Apples",
        10,
        2.5
    ],
    [
        "Bananas",
        15,
        1.2
    ],
    [
        "Apples",
        8,
        2.5
    ],
    [
        "Oranges",
        12,
        3.0
    ],
    [
        "Total Apples Quantity:",
        "=SUMIF(A2:A5,\"Apples\",B2:B5)"
    ],
    [
        "Revenue from Apples:",
        "=SUMIF(A2:A5,\"Apples\",C2:C5)*SUMIF(A2:A5,\"Apples\",B2:B5)"
    ]
]

        return {
            data
        };
    }
}
</script>

import { Component, ViewChild, ElementRef } from "@angular/core";
import jspreadsheet from "jspreadsheet";
import * as formula from "@jspreadsheet/formula-pro";

// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('YjM5OWJjMTc4ZGY2YzQ2NmRiOGM1MmRiOTE3MmQwOWZiNzE0NDdjNDRmZGQyNDVkOWYxYWY1ZTA2MTIwOGUyMzY5NzUwY2VjY2UzNzU4Y2E0YzBkMGZiNDcyNzI2MzI1YzRlOWE0NWYwNjg0ZjRkODIwZWU1NjUzYTU5ZmYxNzMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOVFEyTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

@Component({
    standalone: true,
    selector: "app-root",
    template: `<div #spreadsheet></div>`
})
export class AppComponent {
    @ViewChild("spreadsheet") spreadsheet: ElementRef;
    // Worksheets
    worksheets: jspreadsheet.worksheetInstance[];

    // Create a new data grid
    ngAfterViewInit() {
        // Create spreadsheet
        this.worksheets = jspreadsheet(this.spreadsheet.nativeElement, {
            worksheets: [{
                data: [
    [
        "Product",
        "Quantity",
        "Price"
    ],
    [
        "Apples",
        10,
        2.5
    ],
    [
        "Bananas",
        15,
        1.2
    ],
    [
        "Apples",
        8,
        2.5
    ],
    [
        "Oranges",
        12,
        3.0
    ],
    [
        "Total Apples Quantity:",
        "=SUMIF(A2:A5,\"Apples\",B2:B5)"
    ],
    [
        "Revenue from Apples:",
        "=SUMIF(A2:A5,\"Apples\",C2:C5)*SUMIF(A2:A5,\"Apples\",B2:B5)"
    ]
]
            }]
        });
    }
}

Edit this page on GitHub