Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

session

package module

Go to main page

Versions in this module

v1

v1.0.0

Oct 17, 2026

v0

v0.2.0

Jul 11, 2026

Changes in this version

+ var ErrNilSession = errors.New("session: nil session")

type Option

+ func WithAbsoluteTTL(d time.Duration) Option

v0.1.0

Jul 11, 2026

Changes in this version

+ var ErrExpired = errors.New("session: session expired")

+ var ErrInvalid = errors.New("session: invalid session cookie")

+ var ErrNoSession = errors.New("session: no session cookie")

+ var ErrTooLarge = errors.New("session: encoded session too large for a cookie")

+ type Manager struct

+ func New(secret []byte, opts ...Option) *Manager

+ func (m *Manager) Destroy(w http.ResponseWriter)

+ func (m *Manager) Load(r *http.Request) (*Session, error)

+ func (m *Manager) LoadOrNew(r *http.Request) *Session

+ func (m *Manager) Middleware(next http.Handler) http.Handler

+ func (m *Manager) Save(w http.ResponseWriter, s *Session) error

+ type Option func(*Manager)

+ func WithClock(now func() time.Time) Option

+ func WithDomain(domain string) Option

+ func WithKey(key []byte) Option

+ func WithName(name string) Option

+ func WithPath(path string) Option

+ func WithSameSite(mode http.SameSite) Option

+ func WithSecure(secure bool) Option

+ func WithTTL(d time.Duration) Option

+ type Session struct

+ CreatedAt time.Time

+ ExpiresAt time.Time

+ ID string

+ Subject string

+ Values map[string]string

+ func From(ctx context.Context) (*Session, bool)

+ func (s *Session) Delete(key string)

+ func (s *Session) Get(key string) string

+ func (s *Session) RegenerateID() error

+ func (s *Session) Set(key, value string)