PHPackages                             state/og-generator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. state/og-generator

ActiveLibrary[Utility & Helpers](/categories/utility)

state/og-generator
==================

v1.0.0(1y ago)1892[1 issues](https://github.com/State-Built/og-generator/issues)proprietaryPHP

Since Jul 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/State-Built/og-generator)[ Packagist](https://packagist.org/packages/state/og-generator)[ RSS](/packages/state-og-generator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

Automatically generate images based on the title of your entries, customize backgrounds and fonts via the cp!

How to Install
--------------

[](#how-to-install)

You can search for this addon in the `Tools > Addons` section of the Statamic control panel and click **install**, or run the following command from your project root:

BASH

```
composer require state/og-generator
```

Configuration
-------------

[](#configuration)

You can configure via the cp by clicking "OG Generator" in the sidebar, and customize the form.

### Options

[](#options)

#### Background

[](#background)

You can customize the background by choosing either background image or color, then choose an image or pick a color.

#### Font

[](#font)

You can upload your own ttf files, you can download ttf files from google fonts. Then you can set your font size and color.

Top and left will offset and place the text based on the values.

#### Size

[](#size)

To set the size of the image set the width and height. I recommend creating a higher resolution image initially, because the text can be fuzzy at a lower resolution.

#### Text wrapping

[](#text-wrapping)

To wrap text at a certain point set the wrap at value, it is the number of characters until wrap, not pixels.

#### Collections

[](#collections)

The last option to configure is to pick which collections the og generator will run on when saved.

Usage
-----

[](#usage)

If you configured the addon to generate on save for collections you can access the og\_generator\_image field on your entry as a normal asset field.

HTML

```
{{ if og_generator_image }}

{{ else }}
    {{ asset url="/assets/ogimage-default.jpg" }}

    {{ /asset }}
{{ /if }}
```

Otherwise, you could use the built-in tags, these will generate new images if they don't exist and work on every collection.

HTML

```
{{ og_generator:og_image }}

{{ og_generator:image class="rounded" }}

```

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance14

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

649d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cf7ca57075751c1182b311e5747c864dd4a4ab497073d10b51007a51cd573284?d=identicon)[ChristianPav](/maintainers/ChristianPav)

---

Top Contributors

[![ChristianPavilonis](https://avatars.githubusercontent.com/u/16183252?v=4)](https://github.com/ChristianPavilonis "ChristianPavilonis (7 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/state-og-generator/health.svg)

```
[![Health](https://phpackages.com/badges/state-og-generator/health.svg)](https://phpackages.com/packages/state-og-generator)
```

###  Alternatives

[laravolt/avatar

Turn name, email, and any other string into initial-based avatar or gravatar.

2.0k5.4M31](/packages/laravolt-avatar)[illuminate/pipeline

The Illuminate Pipeline package.

9446.6M210](/packages/illuminate-pipeline)[beyondcode/laravel-favicon

Create dynamic favicons based on your environment settings.

37345.5k](/packages/beyondcode-laravel-favicon)[symfony/ux-cropperjs

Cropper.js integration for Symfony

19280.3k3](/packages/symfony-ux-cropperjs)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[alt-design/alt-sitemap

Alt Sitemap addon, create a sitemap from Statamic entries

1219.0k](/packages/alt-design-alt-sitemap)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)