PHPackages                             riclep/laravel-storyblok - 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. [API Development](/categories/api)
4. /
5. riclep/laravel-storyblok

ActiveLibrary[API Development](/categories/api)

riclep/laravel-storyblok
========================

A Laravel wrapper around the Storyblok API to provide a familiar experience for Laravel devs

2.52.0(2mo ago)6272.7k↓13.1%17[3 issues](https://github.com/RicLeP/laravel-storyblok/issues)[2 PRs](https://github.com/RicLeP/laravel-storyblok/pulls)3MITPHPPHP ^8.3|^8.4CI failing

Since Nov 13Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/RicLeP/laravel-storyblok)[ Packagist](https://packagist.org/packages/riclep/laravel-storyblok)[ Docs](https://github.com/RicLeP/laravel-storyblok/)[ Fund](https://ko-fi.com/riclep)[ RSS](/packages/riclep-laravel-storyblok/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (26)Versions (189)Used By (3)

Use Storyblok’s amazing headless CMS with Laravel
=================================================

[](#use-storybloks-amazing-headless-cms-with-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/65607eca30afc75bb6d53af20e396fb235f96c287e3afd471334735f38dc0d2b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7269636c65702f6c61726176656c2d73746f7279626c6f6b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/riclep/laravel-storyblok)[![Total Downloads](https://camo.githubusercontent.com/4862fbf1b0ef9bd1c71e6990b2562d66c9d4f46dc68e36090515b9686a7fe260/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7269636c65702f6c61726176656c2d73746f7279626c6f6b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/riclep/laravel-storyblok)

[![GitHub Workflow Status](https://camo.githubusercontent.com/791f2f737807a1699ac0422b1d07535659f44755fc67d6d5a4e5b76e10cf1b62/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f7269636c65702f6c61726176656c2d73746f7279626c6f6b2f5465737473)](https://camo.githubusercontent.com/791f2f737807a1699ac0422b1d07535659f44755fc67d6d5a4e5b76e10cf1b62/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f7269636c65702f6c61726176656c2d73746f7279626c6f6b2f5465737473)[![Packagist PHP Version](https://camo.githubusercontent.com/98fd3b8dea82cd2b7d74ee21a378e3567d9dca3f2f44fc51a913cece65fb982f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f7269636c65702f6c61726176656c2d73746f7279626c6f6b2f706870)](https://camo.githubusercontent.com/98fd3b8dea82cd2b7d74ee21a378e3567d9dca3f2f44fc51a913cece65fb982f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f7269636c65702f6c61726176656c2d73746f7279626c6f6b2f706870)

[![Build](https://camo.githubusercontent.com/70f1a49bc2dc332afa472813435ca1fd19cdaf91bbcd4f615ab24001a7fd9eac/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f6275696c642f672f7269636c65702f6c61726176656c2d73746f7279626c6f6b3f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/riclep/laravel-storyblok)[![Quality Score](https://camo.githubusercontent.com/30fac8c019820134a8103658a005e086f73bbd642f6c093b37295e2e6baae9ea/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7269636c65702f6c61726176656c2d73746f7279626c6f6b2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/riclep/laravel-storyblok)

[![ko-fi](https://camo.githubusercontent.com/201ef269611db7eb6b5d08e9f756ab8980df3014b64492770bdf13a6ed924641/68747470733a2f2f6b6f2d66692e636f6d2f696d672f676974687562627574746f6e5f736d2e737667)](https://ko-fi.com/M4M2C42W6)[![Twitter](https://camo.githubusercontent.com/3ee100c1d9b9f6f3dcd78ade7c8b59d50202431f53fafcaa1e5ce0215633714c/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f7269636c65702e7376673f7374796c653d736f6369616c266c6162656c3d466f6c6c6f77)](https://twitter.com/intent/follow?screen_name=riclep)

This package allows you to use fantastic [Storyblok headless CMS](https://www.storyblok.com/) with the amazing [Laravel PHP framework](https://laravel.com/). It’s designed to try and feel natural to Laravel developers and part of the ecosystem whilst also converting Storyblok’s API JSON responses into something powerful with minimal effort.

### Key Features

[](#key-features)

- Pages from Storyblok mapped to PHP Pages classes giving access to the nested content (Blocks) and meta data for SEO, OpenGraph and more.
- Quickly and easily resolve relations and inverse relations between content.
- Each Storyblok component is automatically transformed into a PHP class using a simple naming convention - just match your class and component names.
- Fields in your components are converted to a Field PHP class allowing you to manipulate their data. The package automatically detects common types like richtext fields, assets and markdown. Easily cast fields to classes.
- Asset fields are converted to Assets and Image classes allowing you to manipulate them as required. Images can be easily transformed using Storyblok’s Asset CDN or external services like Imgix.
- Blocks and fields know where they sit in relation to their ancestors and [CSS classes](https://github.com/RicLeP/laravel-storyblok-css) can be created to help your styling.
- The structure of the JSON data is preserved but super powered making it simple to loop over in your views.
- It’s simple to link to the Storyblok visual composer by including one view and printing a string in a Block’s Blade template.
- Request ‘Folders’ of content such as a list of articles or a team of people complete with support for pagination.
- Richer Typography using a [supporting package](https://github.com/RicLeP/laravel-storyblok-typography) utilising PHP Typography.

Documentation
-------------

[](#documentation)

[Read the full docs](https://ls.sirric.co.uk/docs)

[Contribute to the docs](https://github.com/RicLeP/laravel-storyblok-docs/)

Other Packages
--------------

[](#other-packages)

### Laravel Storyblok Embed

[](#laravel-storyblok-embed)

Embed all types of media in your Storyblok site using only their URL. [Package](https://github.com/RicLeP/laravel-storyblok-embed) [Docs](https://ls.sirric.co.uk/docs/2.19/embedding-media)

### Laravel Storyblok Typography

[](#laravel-storyblok-typography)

Improve your content’s typography. [Package](https://github.com/RicLeP/laravel-storyblok-typography) [Docs](https://ls.sirric.co.uk/docs/2.19/typography)

### Laravel Storyblok Layout &amp; CSS

[](#laravel-storyblok-layout--css)

Helpers for layout, block positioning and CSS class name generation. [Package](https://github.com/RicLeP/laravel-storyblok-css) [Docs](https://ls.sirric.co.uk/docs/2.19/css-classes)

### Laravel Storyblok Form builder (BETA)

[](#laravel-storyblok-form-builder-beta)

Build forms with Storyblok complete with Laravel’s validation. [Package](https://github.com/RicLeP/laravel-storyblok-forms) [Docs](https://ls.sirric.co.uk/docs/2.19/laravel-storyblok-forms)

### Laravel Storyblok CLI

[](#laravel-storyblok-cli)

Useful Artisan commands to help manage your content? Check out my [Laravel Storyblok CLI package](https://github.com/RicLeP/laravel-storyblok-cli)

### Testing

[](#testing)

The tests are mostly up-to-date and cover the majority of the code. A few areas that would require hitting the Storyblok API are not tested. If you have experience mocking API please feel free to contribute tests.

### Changelog

[](#changelog)

[See it here](CHANGELOG.md)

Contributing
------------

[](#contributing)

Please feel free to help expand and improve this project.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

[![img](https://camo.githubusercontent.com/b47b1b6d92ca36b524e608c8073cc8d751e60d8b445d78a9c57662a1cbc9f015/68747470733a2f2f6c732e7369727269632e636f2e756b2f696d672f73746f7279626c6f6b2d616d6261737361646f722d61737365742d766572742d636f6c6f722e737667)](https://camo.githubusercontent.com/b47b1b6d92ca36b524e608c8073cc8d751e60d8b445d78a9c57662a1cbc9f015/68747470733a2f2f6c732e7369727269632e636f2e756b2f696d672f73746f7279626c6f6b2d616d6261737361646f722d61737365742d766572742d636f6c6f722e737667)

- Ric Le Poidevin [GitHub](https://github.com/riclep) / [Twitter](https://twitter.com/riclep)
- [The contributors](https://github.com/RicLeP/laravel-storyblok/graphs/contributors) 😍
- [Storyblok](https://www.storyblok.com/) 😻
- [Laravel](https://laravel.com/) 🥰
- [Built and developed at U&amp;US](https://uandus.co.uk) 💕

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Laravel Package Boilerplate
---------------------------

[](#laravel-package-boilerplate)

This package was generated using the [Laravel Package Boilerplate](https://laravelpackageboilerplate.com).

###  Health Score

68

—

FairBetter than 100% of packages

Maintenance88

Actively maintained with recent releases

Popularity45

Moderate usage in the ecosystem

Community27

Small or concentrated contributor base

Maturity94

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 91.3% 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

Every ~12 days

Recently: every ~38 days

Total

181

Last Release

63d ago

Major Versions

0.2.0 → 1.0.0-beta12020-03-04

1.2.0 → 2.0.0-beta12020-07-10

1.2.1 → 2.1.02020-09-18

1.8.2 → 2.8.22021-12-01

PHP version history (9 changes)0.0.1PHP ^7.1

2.4.0PHP ^7.1|^8.0

2.8.0-betaPHP ^7.4|^8.0

2.13.0PHP ^8.0

2.21.0PHP ^8.0|^8.1|^8.2

2.27.0PHP ^8.0|^8.1|^8.2|^8.3

2.29.0PHP ^8.1|^8.2|^8.3

2.38.0PHP ^8.2|^8.3|^8.4

2.47PHP ^8.3|^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/8cc0947c5075928ca6160ab3c81f608db980edaefafd50fd904d060ba5c40817?d=identicon)[ric@sirric.co.uk](/maintainers/ric@sirric.co.uk)

---

Top Contributors

[![RicLeP](https://avatars.githubusercontent.com/u/19726976?v=4)](https://github.com/RicLeP "RicLeP (397 commits)")[![WL1981](https://avatars.githubusercontent.com/u/43273688?v=4)](https://github.com/WL1981 "WL1981 (12 commits)")[![chaseconey](https://avatars.githubusercontent.com/u/1449463?v=4)](https://github.com/chaseconey "chaseconey (6 commits)")[![codyworthen](https://avatars.githubusercontent.com/u/106708797?v=4)](https://github.com/codyworthen "codyworthen (6 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (3 commits)")[![lantiguav](https://avatars.githubusercontent.com/u/20170028?v=4)](https://github.com/lantiguav "lantiguav (2 commits)")[![czuniga9](https://avatars.githubusercontent.com/u/99490526?v=4)](https://github.com/czuniga9 "czuniga9 (2 commits)")[![roberto-butti](https://avatars.githubusercontent.com/u/678434?v=4)](https://github.com/roberto-butti "roberto-butti (2 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (2 commits)")[![marvinosswald](https://avatars.githubusercontent.com/u/1621844?v=4)](https://github.com/marvinosswald "marvinosswald (1 commits)")[![brentmullen](https://avatars.githubusercontent.com/u/4369463?v=4)](https://github.com/brentmullen "brentmullen (1 commits)")[![rversantos](https://avatars.githubusercontent.com/u/102093303?v=4)](https://github.com/rversantos "rversantos (1 commits)")

---

Tags

content-managementcontent-management-systemheadlessheadless-cmslaravelphpstoryblokstoryblok-apistoryblok-clientlaravelcmscontent managementstoryblokheadless cms

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/riclep-laravel-storyblok/health.svg)

```
[![Health](https://phpackages.com/badges/riclep-laravel-storyblok/health.svg)](https://phpackages.com/packages/riclep-laravel-storyblok)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.2k438.5k29](/packages/tightenco-jigsaw)[joy/voyager-api

This Laravel/Voyager module adds REST Api with swagger support to Voyager.

204.7k3](/packages/joy-voyager-api)[alibori/laravel-api-resource-generator

Package to generate API resources from models.

222.6k](/packages/alibori-laravel-api-resource-generator)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

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