1. Products
  2.   Aspose.PDF
  3.   Aspose.PDF FOSS for Go

Aspose.PDF FOSS for Go

Pure-Go library for creating, editing, merging, and securing PDF documents — open source under MIT, zero non-Go dependencies.

Aspose.PDF FOSS for Go Aspose.PDF FOSS
for Go

Documentation GitHub

Aspose.PDF FOSS — Open Source Go PDF Library

Aspose.PDF FOSS for Go is a pure-Go library that enables developers to create, read, edit, merge, split, and secure PDF documents without any external native dependencies. Built for server-side Go applications, it integrates into any Go module project with a single go get github.com/aspose-pdf-foss/aspose-pdf-foss-for-go command.

The library exposes a comprehensive API surface through the Document, Page, Form, Table, and AnnotationCollection types, covering document management, AcroForm filling, structured table layout, bookmark navigation, image handling, and PDF/A-level validation. Security features include AES-128, AES-256, and RC4-128 encryption via EncryptionOptions and Permissions, with granular per-operation access control. Aspose.PDF FOSS for Go is released under the MIT license with no runtime fees or usage restrictions. Requires Go 1.24 or later. For the enterprise product family, see the Aspose.PDF — Enterprise Product Family.

Document Operations

  • Open, create, save, and close PDF files via Document
  • Split a document into per-page Document instances
  • Append multiple PDFs in-place using Append
  • Extract page subsets using PageRange for partial exports
  • Read and write XMP/Info metadata through Metadata

Practical scenarios

  • Batch-split incoming PDFs into individual page archives
  • Assemble monthly reports from section PDFs
  • Extract page ranges for redacted-copy workflows
  • Update document author and creation date programmatically

Security and Permissions

  • Encrypt PDFs with AES-128, AES-256, or RC4-128 via EncryptionOptions
  • Set user and owner passwords in a single SetEncryption call
  • Restrict print, copy, and accessibility using Permissions
  • Open password-protected files with OpenWithPassword
  • Remove encryption and produce decrypted copies when needed

Practical scenarios

  • Deliver confidential reports with per-recipient passwords
  • Enforce print-only permissions on distributed contracts
  • Re-encrypt documents after watermarking in-place
  • Produce plaintext archive copies from protected originals

AcroForm Processing

  • Enumerate all fields in a form using Form and Field
  • Set text values on TextBoxField instances by field name
  • Toggle CheckboxField and select RadioButtonField options
  • Choose items in ComboBoxField and ListBoxField controls
  • Trigger ButtonField actions in interactive form documents

Practical scenarios

  • Automate invoice and contract form filling pipelines
  • Pre-populate application templates before PDF distribution
  • Extract filled field values for downstream data processing
  • Validate required field presence before archival

Tables and Structured Layout

  • Build grid layouts with Table, Row, and Cell types
  • Apply border styles through BorderInfo per cell or table
  • Set padding and spacing with MarginInfo
  • Style text with TextStyle, Font, Color, HAlign, and VAlign
  • Embed images inside table cells using Image

Practical scenarios

  • Generate invoices and financial statements with tabular data
  • Render schedule or comparison tables in generated reports
  • Produce data-driven PDFs from database query results
  • Create accessible tables with consistent border and spacing

Bookmarks and Navigation

  • Create hierarchical bookmark trees via OutlineItemCollection
  • Set bold/italic styles and custom colors on outline items
  • Link bookmarks to exact coordinates using DestinationXYZ
  • Use page-fit destinations with DestinationFit
  • Register named jump targets through NamedDestinations

Practical scenarios

  • Add chapter and section bookmarks to long-form documents
  • Build interactive tables of contents for technical manuals
  • Enable deep-link navigation from external hyperlinks
  • Preserve bookmark structure when merging multiple documents

Annotations and Stamps

  • Add comments via Annotation and AnnotationCollection
  • Create text callouts with TextAnnotation and FreeTextAnnotation
  • Apply approval stamps via StampAnnotation and StampName
  • Highlight content with HighlightAnnotation
  • Redact sensitive regions using RedactAnnotation

Practical scenarios

  • Add reviewer comments to draft documents for approval
  • Stamp APPROVED or CONFIDENTIAL on finalized PDFs
  • Permanently redact personal data for GDPR-compliant archives
  • Embed hyperlinks and URI actions via LinkAnnotation

Split and Merge PDFs

Open a PDF, split it into per-page documents, or merge multiple files into one.

doc, _ := pdf.Open("input.pdf")
pages, _ := doc.Split()
for i, p := range pages {
    p.Save(fmt.Sprintf("page%03d.pdf", i+1))
}
doc2, _ := pdf.Open("file2.pdf")
doc.Append(doc2)
doc.Save("merged.pdf")

Encrypt with Permissions

Apply AES-128 encryption with granular print and copy permissions in one call.

doc, _ := pdf.Open("input.pdf")
doc.SetEncryption(pdf.EncryptionOptions{
    UserPassword:  "userpass",
    OwnerPassword: "ownerpass",
    Permissions:   &pdf.Permissions{AllowPrint: true, AllowCopy: true},
})
doc.Save("restricted.pdf")

Fill AcroForm Fields

Target form fields by name and set values for all widget types.

doc, _ := pdf.Open("template.pdf")
text := doc.Form().Field("name").(*pdf.TextBoxField)
text.SetValue("Jane Doe")
check := doc.Form().Field("subscribe").(*pdf.CheckboxField)
check.SetChecked(true)
radio := doc.Form().Field("plan").(*pdf.RadioButtonField)
radio.Options()[1].SetSelected(true)
doc.Save("filled.pdf")

Create Hierarchical Bookmarks

Build a nested bookmark tree with styled entries and precise page destinations.

doc, _ := pdf.Open("input.pdf")
page, _ := doc.Page(1)
chapter := pdf.NewOutlineItemCollection(doc)
chapter.SetTitle("Chapter 1")
chapter.SetBold(true)
chapter.SetDestination(pdf.NewDestinationXYZ(page, 0, 800, 1.0))
doc.Outlines().Add(chapter)
doc.Save("with_bookmarks.pdf")

Frequently Asked Questions

What is the license for Aspose.PDF FOSS for Go?

Aspose.PDF FOSS for Go is released under the MIT License. The full license text is included in the repository at github.com/aspose-pdf-foss/aspose-pdf-foss-for-go.

Can I use Aspose.PDF FOSS for Go in a commercial product?

Yes. The MIT license permits unrestricted commercial use, modification, distribution, and private use.

Is there an enterprise version?

Aspose.PDF FOSS is the open-source, MIT-licensed edition. A separate commercial Aspose.PDF product is available at products.aspose.com/pdf/ with enterprise support, extended format coverage, and cloud integration.

How do I install Aspose.PDF FOSS for Go?

Add the module to your Go project: bash go get github.com/aspose-pdf-foss/aspose-pdf-foss-for-go Import it with an alias in your source files: go import pdf 'github.com/aspose-pdf-foss/aspose-pdf-foss-for-go'

What Go version is required?

Go 1.24 or later is required. Verify your version with go version.

  

Support and Learning Resources

  
Aspose.PDF Enterprise ProductDemos