explaingit

tealeg/xlsx

★ 5,999GoAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A Go library for reading and writing Microsoft Excel XLSX files, now officially moved to Codeberg with no further maintenance on GitHub.

Mindmap

mindmap
  root((tealeg/xlsx))
    What it does
      Read Excel files
      Write Excel files
      Go library
    Status
      Moved to Codeberg
      GitHub no maintenance
      v4 on Codeberg
    Tech stack
      Go
      XML parsing
    Use cases
      Data import
      Report export
      Sheet parsing
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Read data from an uploaded Excel spreadsheet in a Go web service and process it row by row.

USE CASE 2

Export query results from a Go program as a formatted .xlsx file for business users.

USE CASE 3

Parse an Excel workbook with multiple sheets and extract specific column values.

Tech stack

Go

Getting it running

Difficulty · easy Time to first run · 5min

The GitHub version is no longer maintained, use the Codeberg v4 repository for new projects.

BSD license -- use freely in commercial and personal projects with minimal restrictions.

In plain English

This repository contains a Go library for reading and writing XLSX files, the format used by Microsoft Excel since 2002. If you are building a Go program that needs to import data from spreadsheets or export results as Excel files, this library handles the underlying XML parsing and file structure so you do not have to. The README includes a migration notice at the top: the project has moved to Codeberg, a different code hosting platform, and the GitHub-hosted version will no longer receive maintenance or support. The active version is now at codeberg.org/tealeg/xlsx, bumped to v4. New users should go there for current documentation, releases, and the issue tracker. The library has gone through several major versions, each introducing breaking API changes. Versions 1.x and 2.x are considered legacy. Version 3 was the most recent stable release on GitHub. The project started in the early days of Go as a quick internal tool and grew into a widely used library as the Go ecosystem matured. A tutorial for getting started with the library is available in the repository at tutorial/tutorial.adoc. If you are using an existing v1 or v2 codebase and do not need new features, those older versions still exist on GitHub. However, the maintainer recommends going to Codeberg for anything new. Patches and new contributions are accepted only on the Codeberg repository. The license is BSD, which permits broad reuse including in commercial applications with minimal requirements.

Copy-paste prompts

Prompt 1
I'm using the tealeg/xlsx Go library (v3). Show me how to open an Excel file and iterate over every row in the first sheet.
Prompt 2
How do I create a new Excel file with multiple sheets using tealeg/xlsx and write values to specific cells?
Prompt 3
The readme says tealeg/xlsx moved to Codeberg. What is the correct import path for v4 and how do I update my go.mod?
Open on GitHub → Explain another repo

← tealeg on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.