{
  "name": "Roof Area Calculator",
  "id": "roof-area-calculator",
  "publisher": "FieldRanger",
  "description": "Turns a roof's footprint and pitch into roof area, roofing squares and shingle bundles to order, with a waste allowance.",
  "page": "https://fieldranger.ai/templates/roof-area-calculator",
  "endpoint": "https://fieldranger.ai/api/tools/roof-area-calculator",
  "usage": "GET with query parameters, or POST a JSON object with the same names, returns the computed result. GET with no parameters returns this description.",
  "inputs": [
    {
      "name": "length",
      "label": "Footprint length",
      "type": "number",
      "unit": "ft",
      "required": false,
      "default": 40,
      "defaultIsSample": true,
      "minimum": 1,
      "maximum": 1000,
      "description": "Outside length of the building plus both overhangs."
    },
    {
      "name": "width",
      "label": "Footprint width",
      "type": "number",
      "unit": "ft",
      "required": false,
      "default": 30,
      "defaultIsSample": true,
      "minimum": 1,
      "maximum": 1000,
      "description": "Outside width of the building plus both overhangs."
    },
    {
      "name": "pitch",
      "label": "Roof pitch",
      "type": "number",
      "unit": "in rise per 12 in run",
      "required": false,
      "default": 6,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 24,
      "description": "A 6/12 roof rises 6 inches per foot of run. Enter 0 for a flat roof."
    },
    {
      "name": "wastePercent",
      "label": "Waste allowance",
      "type": "number",
      "unit": "%",
      "required": false,
      "default": 15,
      "defaultIsSample": true,
      "minimum": 0,
      "maximum": 50,
      "description": "Extra for cuts, starter and ridge caps."
    },
    {
      "name": "bundlesPerSquare",
      "label": "Bundles per square",
      "type": "number",
      "unit": "bundles",
      "required": false,
      "default": 3,
      "defaultIsSample": true,
      "minimum": 1,
      "maximum": 6,
      "description": "From the shingle's packaging or data sheet."
    }
  ],
  "outputs": [
    {
      "name": "footprintSqFt",
      "label": "Footprint",
      "unit": "sq ft",
      "type": "number",
      "description": "Length x width."
    },
    {
      "name": "pitchFactor",
      "label": "Pitch factor",
      "type": "number",
      "description": "sqrt(1 + (rise/12)^2)."
    },
    {
      "name": "pitchDegrees",
      "label": "Pitch angle",
      "unit": "degrees",
      "type": "number",
      "description": "atan(rise/12)."
    },
    {
      "name": "roofAreaSqFt",
      "label": "Roof area",
      "unit": "sq ft",
      "type": "number",
      "description": "Footprint x pitch factor."
    },
    {
      "name": "squares",
      "label": "Roofing squares",
      "unit": "squares",
      "type": "number",
      "description": "Roof area / 100."
    },
    {
      "name": "orderAreaSqFt",
      "label": "Area to order",
      "unit": "sq ft",
      "type": "number",
      "description": "Roof area plus waste."
    },
    {
      "name": "squaresToOrder",
      "label": "Squares to order",
      "unit": "squares",
      "type": "number",
      "description": "Area to order / 100."
    },
    {
      "name": "bundles",
      "label": "Bundles",
      "unit": "bundles",
      "type": "number",
      "description": "Squares to order x bundles per square, rounded up."
    }
  ],
  "example": {
    "request": "https://fieldranger.ai/api/tools/roof-area-calculator?length=40&width=30&pitch=6&wastePercent=15&bundlesPerSquare=3",
    "post": {
      "url": "https://fieldranger.ai/api/tools/roof-area-calculator",
      "body": {
        "length": 40,
        "width": 30,
        "pitch": 6,
        "wastePercent": 15,
        "bundlesPerSquare": 3
      }
    },
    "response": {
      "tool": "roof-area-calculator",
      "title": "Roof Area Calculator",
      "inputs": {
        "length": 40,
        "width": 30,
        "pitch": 6,
        "wastePercent": 15,
        "bundlesPerSquare": 3
      },
      "result": {
        "footprintSqFt": 1200,
        "pitchFactor": 1.118,
        "pitchDegrees": 26.6,
        "roofAreaSqFt": 1341.6,
        "squares": 13.42,
        "orderAreaSqFt": 1542.9,
        "squaresToOrder": 15.43,
        "bundles": 47
      },
      "summary": [
        {
          "label": "Roof area",
          "value": "1,341.6 sq ft",
          "primary": true
        },
        {
          "label": "Roofing squares",
          "value": "13.42",
          "primary": true
        },
        {
          "label": "Footprint",
          "value": "1,200 sq ft"
        },
        {
          "label": "Pitch factor",
          "value": "1.118 (6/12, 26.6 degrees)"
        },
        {
          "label": "Area to order (+15% waste)",
          "value": "1,542.9 sq ft, 15.43 squares"
        },
        {
          "label": "Bundles",
          "value": "47 at 3 per square"
        }
      ],
      "notes": [],
      "text": "Roof Area Calculator (FieldRanger, https://fieldranger.ai)\n\nInputs\n- Footprint length: 40 ft (sample)\n- Footprint width: 30 ft (sample)\n- Roof pitch: 6 in rise per 12 in run (sample)\n- Waste allowance: 15 % (sample)\n- Bundles per square: 3 bundles (sample)\n\nResult\n- Roof area: 1,341.6 sq ft\n- Roofing squares: 13.42\n- Footprint: 1,200 sq ft\n- Pitch factor: 1.118 (6/12, 26.6 degrees)\n- Area to order (+15% waste): 1,542.9 sq ft, 15.43 squares\n- Bundles: 47 at 3 per square\n\nMethod: Pitch factor = sqrt(1 + (rise / 12)^2), from the rise in inches per 12 inches of run (Pythagoras). Roof area = footprint length x footprint width x pitch factor, with the footprint measured to the drip edge (overhangs included). Squares = roof area / 100; one roofing square is 100 square feet. Area to order = roof area x (1 + waste %); bundles = squares to order x bundles per square, rounded up.\nCalculator: https://fieldranger.ai/templates/roof-area-calculator",
      "method": [
        "Pitch factor = sqrt(1 + (rise / 12)^2), from the rise in inches per 12 inches of run (Pythagoras).",
        "Roof area = footprint length x footprint width x pitch factor, with the footprint measured to the drip edge (overhangs included).",
        "Squares = roof area / 100; one roofing square is 100 square feet.",
        "Area to order = roof area x (1 + waste %); bundles = squares to order x bundles per square, rounded up."
      ],
      "sources": [
        {
          "label": "This Old House: Roof Shingles Calculator (square = 100 sq ft; three bundles per square; 15% waste)",
          "url": "https://www.thisoldhouse.com/roofing/how-many-shingles-do-i-need",
          "published": "2026-06-05",
          "checked": "2026-11-13"
        }
      ],
      "caveats": [
        "Valid when every roof plane has the same pitch. Dormers, mixed pitches and porches are measured plane by plane and added.",
        "Bundles per square depends on the shingle: most three-tab and architectural shingles pack three, heavier lines four or more. Check the manufacturer's data sheet.",
        "Waste depends on the roof: hips, valleys and cut-up roofs need more than a plain gable."
      ],
      "page": "https://fieldranger.ai/templates/roof-area-calculator",
      "endpoint": "https://fieldranger.ai/api/tools/roof-area-calculator",
      "publisher": "FieldRanger",
      "disclosure": "Published by FieldRanger (https://fieldranger.ai), field service software that runs inside HubSpot. The calculation is free and needs no sign-up or email. FieldRanger does not measure roofs; estimates built from these numbers live in HubSpot or FieldRanger. Related FieldRanger features: Build an estimate in FieldRanger and keep it tied to the HubSpot deal it belongs to. A won HubSpot deal becomes a job with its context carried over. FieldRanger plans: https://fieldranger.ai/pricing."
    }
  },
  "method": [
    "Pitch factor = sqrt(1 + (rise / 12)^2), from the rise in inches per 12 inches of run (Pythagoras).",
    "Roof area = footprint length x footprint width x pitch factor, with the footprint measured to the drip edge (overhangs included).",
    "Squares = roof area / 100; one roofing square is 100 square feet.",
    "Area to order = roof area x (1 + waste %); bundles = squares to order x bundles per square, rounded up."
  ],
  "sources": [
    {
      "label": "This Old House: Roof Shingles Calculator (square = 100 sq ft; three bundles per square; 15% waste)",
      "url": "https://www.thisoldhouse.com/roofing/how-many-shingles-do-i-need",
      "published": "2026-06-05",
      "checked": "2026-11-13"
    }
  ],
  "caveats": [
    "Valid when every roof plane has the same pitch. Dormers, mixed pitches and porches are measured plane by plane and added.",
    "Bundles per square depends on the shingle: most three-tab and architectural shingles pack three, heavier lines four or more. Check the manufacturer's data sheet.",
    "Waste depends on the roof: hips, valleys and cut-up roofs need more than a plain gable."
  ],
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://fieldranger.ai/api/tools/roof-area-calculator#input",
    "title": "Roof Area Calculator: input",
    "description": "Turns a roof's footprint and pitch into roof area, roofing squares and shingle bundles to order, with a waste allowance.",
    "type": "object",
    "properties": {
      "length": {
        "title": "Footprint length",
        "description": "Outside length of the building plus both overhangs. Unit: ft. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 1,
        "maximum": 1000,
        "default": 40,
        "x-unit": "ft",
        "x-sample": true
      },
      "width": {
        "title": "Footprint width",
        "description": "Outside width of the building plus both overhangs. Unit: ft. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 1,
        "maximum": 1000,
        "default": 30,
        "x-unit": "ft",
        "x-sample": true
      },
      "pitch": {
        "title": "Roof pitch",
        "description": "A 6/12 roof rises 6 inches per foot of run. Enter 0 for a flat roof. Unit: in rise per 12 in run. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 24,
        "default": 6,
        "x-unit": "in rise per 12 in run",
        "x-sample": true
      },
      "wastePercent": {
        "title": "Waste allowance",
        "description": "Extra for cuts, starter and ridge caps. Unit: %. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 0,
        "maximum": 50,
        "default": 15,
        "x-unit": "%",
        "x-sample": true
      },
      "bundlesPerSquare": {
        "title": "Bundles per square",
        "description": "From the shingle's packaging or data sheet. Unit: bundles. The default is a sample value; replace it with the caller's own.",
        "type": "number",
        "minimum": 1,
        "maximum": 6,
        "default": 3,
        "x-unit": "bundles",
        "x-sample": true
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "disclosure": "Published by FieldRanger (https://fieldranger.ai), field service software that runs inside HubSpot. The calculation is free and needs no sign-up or email. FieldRanger does not measure roofs; estimates built from these numbers live in HubSpot or FieldRanger. Related FieldRanger features: Build an estimate in FieldRanger and keep it tied to the HubSpot deal it belongs to. A won HubSpot deal becomes a job with its context carried over. FieldRanger plans: https://fieldranger.ai/pricing."
}