Skip to content

Added doc for Gaussian Blur in Image Editor #3046

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mnocon wants to merge 4 commits into
base: 4.6
Choose a base branch
from
Open

Added doc for Gaussian Blur in Image Editor #3046

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9b01a29
Added doc for image editor's gaussian blur
mnocon Feb 6, 2026
52dcff4
Added release notes draft
mnocon Feb 6, 2026
12d2a9d
Added review remark
mnocon Feb 17, 2026
127aecc
Added dedicated section
mnocon Feb 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,3 +11,15 @@ auth.json
.yarn
yarn.lock
docs/css/*.map
.cache
.devcontainer
.github
context
AGENTS.md
IMPLEMENTATION.md
PLAN.md
NOTES.md
list
logs/
skills/
notify-user.sh
1 change: 1 addition & 0 deletions code_samples/back_office/image_editor/config/packages/image_editor.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,3 +38,4 @@ ibexa:
id: dot
priority: 50
image_quality: 0.8
gaussian_blur_strength: 0.05
15 changes: 14 additions & 1 deletion docs/content_management/images/configure_image_editor.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,9 @@
[[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 0, 36) =]]
```

### Image quality
### Image file size optimization

#### Image quality

You can configure the quality of the images modified in the Image Editor with the following configuration.

Expand All @@ -44,6 +46,17 @@
[[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 0, 4) =]] [[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 39, 40) =]]
```

#### Gaussian blur strength

You can configure the gaussian blur strength applied during image optimization with the following configuration.

Check failure on line 51 in docs/content_management/images/configure_image_editor.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/content_management/images/configure_image_editor.md#L51 

[Ibexa.Spellcheck] Did you really mean 'gaussian'?
Raw output 
{"message": "[Ibexa.Spellcheck] Did you really mean 'gaussian'?", "location": {"path": "docs/content_management/images/configure_image_editor.md", "range": {"start": {"line": 51, "column": 23}}}, "severity": "ERROR"}

Check notice on line 51 in docs/content_management/images/configure_image_editor.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/content_management/images/configure_image_editor.md#L51 

[Ibexa.Spelling] Possible spelling error in 'gaussian'.
Raw output 
{"message": "[Ibexa.Spelling] Possible spelling error in 'gaussian'.", "location": {"path": "docs/content_management/images/configure_image_editor.md", "range": {"start": {"line": 51, "column": 23}}}, "severity": "INFO"}
Copy link
Contributor

@julitafalcondusza julitafalcondusza Feb 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about small change of the order? (cannot add as suggestion cause git is confused with ``` from code and suggestion).

You can configure the gaussian (...) configuration:

code

The setting (...)

Copy link
Contributor Author

@mnocon mnocon Feb 17, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, added in 12d2a9d !


``` yaml
[[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 0, 4) =]] [[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 40, 41) =]]
```

The setting accepts values between 0 and 1, where higher values increase blur and reduce file size, while lower values maintain sharpness.

Check notice on line 57 in docs/content_management/images/configure_image_editor.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/content_management/images/configure_image_editor.md#L57 

[Ibexa.Numerals] Spell out numbers until 10.
Raw output 
{"message": "[Ibexa.Numerals] Spell out numbers until 10.", "location": {"path": "docs/content_management/images/configure_image_editor.md", "range": {"start": {"line": 57, "column": 35}}}, "severity": "INFO"}

Check notice on line 57 in docs/content_management/images/configure_image_editor.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/content_management/images/configure_image_editor.md#L57 

[Ibexa.Numerals] Spell out numbers until 10.
Raw output 
{"message": "[Ibexa.Numerals] Spell out numbers until 10.", "location": {"path": "docs/content_management/images/configure_image_editor.md", "range": {"start": {"line": 57, "column": 41}}}, "severity": "INFO"}
The default value is 0.05.

### Additional information

Each image can be accompanied by additional information that isn't visible to the user.
Expand Down
8 changes: 8 additions & 0 deletions docs/release_notes/ibexa_dxp_v4.6.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,14 @@

<div class="release-notes" markdown="1">

<!-- draft release notes -->
### Gaussian Blur Configuration in Image Editor

Check notice on line 14 in docs/release_notes/ibexa_dxp_v4.6.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v4.6.md#L14 

[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings
Raw output 
{"message": "[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings", "location": {"path": "docs/release_notes/ibexa_dxp_v4.6.md", "range": {"start": {"line": 14, "column": 5}}}, "severity": "INFO"}

The [Image Editor]([[= user_doc =]]/image_management/edit_images/) now supports configurable gaussian blur strength for image optimization.

Check notice on line 16 in docs/release_notes/ibexa_dxp_v4.6.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v4.6.md#L16 

[Ibexa.Spelling] Possible spelling error in 'gaussian'.
Raw output 
{"message": "[Ibexa.Spelling] Possible spelling error in 'gaussian'.", "location": {"path": "docs/release_notes/ibexa_dxp_v4.6.md", "range": {"start": {"line": 16, "column": 94}}}, "severity": "INFO"}

Check failure on line 16 in docs/release_notes/ibexa_dxp_v4.6.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v4.6.md#L16 

[Ibexa.Spellcheck] Did you really mean 'gaussian'?
Raw output 
{"message": "[Ibexa.Spellcheck] Did you really mean 'gaussian'?", "location": {"path": "docs/release_notes/ibexa_dxp_v4.6.md", "range": {"start": {"line": 16, "column": 94}}}, "severity": "ERROR"}

Check warning on line 16 in docs/release_notes/ibexa_dxp_v4.6.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v4.6.md#L16 

[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output 
{"message": "[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/release_notes/ibexa_dxp_v4.6.md", "range": {"start": {"line": 16, "column": 140}}}, "severity": "WARNING"}
You can adjust the blur level to balance between file size reduction and image sharpness.
For more information, see [Configure image editor](configure_image_editor.md#gaussian-blur-strength).


[[% set version = 'v4.6.27' %]]
[[= release_note_entry_begin("Ibexa DXP " + version, '2026-02-03', ['Headless', 'Experience', 'Commerce']) =]]

Expand Down
7 changes: 7 additions & 0 deletions docs/release_notes/ibexa_dxp_v5.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,13 @@

<div class="release-notes" markdown="1">

<!-- draft release notes -->
### Gaussian Blur Configuration in Image Editor

Check notice on line 14 in docs/release_notes/ibexa_dxp_v5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v5.0.md#L14 

[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings
Raw output 
{"message": "[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings", "location": {"path": "docs/release_notes/ibexa_dxp_v5.0.md", "range": {"start": {"line": 14, "column": 5}}}, "severity": "INFO"}

The [Image Editor]([[= user_doc =]]/image_management/edit_images/) now supports configurable gaussian blur strength for image optimization.

Check notice on line 16 in docs/release_notes/ibexa_dxp_v5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v5.0.md#L16 

[Ibexa.Spelling] Possible spelling error in 'gaussian'.
Raw output 
{"message": "[Ibexa.Spelling] Possible spelling error in 'gaussian'.", "location": {"path": "docs/release_notes/ibexa_dxp_v5.0.md", "range": {"start": {"line": 16, "column": 94}}}, "severity": "INFO"}

Check failure on line 16 in docs/release_notes/ibexa_dxp_v5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v5.0.md#L16 

[Ibexa.Spellcheck] Did you really mean 'gaussian'?
Raw output 
{"message": "[Ibexa.Spellcheck] Did you really mean 'gaussian'?", "location": {"path": "docs/release_notes/ibexa_dxp_v5.0.md", "range": {"start": {"line": 16, "column": 94}}}, "severity": "ERROR"}

Check warning on line 16 in docs/release_notes/ibexa_dxp_v5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/release_notes/ibexa_dxp_v5.0.md#L16 

[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output 
{"message": "[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/release_notes/ibexa_dxp_v5.0.md", "range": {"start": {"line": 16, "column": 140}}}, "severity": "WARNING"}
You can adjust the blur level to balance between file size reduction and image sharpness.
For more information, see [Configure image editor](configure_image_editor.md#gaussian-blur-strength).

[[% set version = 'v5.0.5' %]]

[[= release_note_entry_begin("Ibexa DXP " + version, '2026-01-15', ['Headless', 'Experience', 'Commerce']) =]]
Expand Down
Loading