resources.GetMatch

Returns the first global resource from paths matching the given glob pattern, or nil if none found.

Syntax

resources.GetMatch PATTERN

Returns

resource.Resource

{{ with resources.GetMatch "images/*.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

This function operates on global resources. A global resource is a file within the assets directory, or within any directory mounted to the assets directory.

For page resources, use the Resources.GetMatch method on a Page object.

Hugo determines a match using a case-insensitive glob pattern.

Path	Pattern	Match
`images/foo/a.jpg`	`images/foo/*.jpg`	`true`
`images/foo/a.jpg`	`images/foo/.`	`true`
`images/foo/a.jpg`	`images/foo/*`	`true`
`images/foo/a.jpg`	`images//.jpg`	`true`
`images/foo/a.jpg`	`images//.*`	`true`
`images/foo/a.jpg`	`images//`	`true`
`images/foo/a.jpg`	`//*.jpg`	`true`
`images/foo/a.jpg`	`//.`	`true`
`images/foo/a.jpg`	`//*`	`true`
`images/foo/a.jpg`	`*/.jpg`	`true`
`images/foo/a.jpg`	`*/.*`	`true`
`images/foo/a.jpg`	`*/`	`true`
`images/foo/a.jpg`	`**`	`true`
`images/foo/a.jpg`	`/.jpg`	`false`
`images/foo/a.jpg`	`*.jpg`	`false`
`images/foo/a.jpg`	`.`	`false`
`images/foo/a.jpg`	`*`	`false`

Last updated: February 17, 2025 : all: Change shortcode usage and design to prevent invalid HTML (0fca8ef25)

Improve this page