Release notes

February 2026

  • Gramax Enterprise Server:

    • Correct links from the application. Previously, links to an article or catalog were copied as app.gram.ax/.... Now the application inserts the domain of your company (where the web editor is deployed), so the links go directly to the corporate website.

    • Filter by attached files. Search modes «Without files», «With files», and «Only in files» have been added to the search, enabling you to search not only by the text of articles but also by the content of PDF and DOCX files.

  • Automatic resolution of conflicts in comments. If several users simultaneously reply to or edit the same comment, the changes are correctly merged and do not break the comments. As a result, a new item «Comments» has been added to «Check for errors» — it shows articles with comments that are not linked to any block.

  • Search improvements:

    • Faster search. The search speed has been increased approximately 2‑fold, and indexing has been optimized.

    • Required words in a query. The + operator has been added: place it before a word or phrase, and they will definitely be taken into account in the results.

    • The article search box now retains its state. When navigating between articles, the search box closes, but when reopened, it retains the entered text (as long as the application is open).

    • AI search has become more accurate. We have improved the RAG, so search results are now more relevant and useful.

  • Inline toolbar in comments, snippets, and templates. Basic formatting options — bold, italic, code, and link insertion — are now available above the comment input field.

    In the snippets editor and templates, a full set of tools has been added, including table editing.

  • Preview for Excel files. Files with .xlsx and .xls extensions can now be opened in preview mode: clicking on them displays a preview in a modal window.

  • Faster publishing. The list of changes now loads 3 times faster.

  • Automatic link updates during editing. If you change the link text and it matches the link address, the address will also be updated. If the text and address differ, the link remains unchanged. See the article for more details.

  • Scroll position is preserved between articles. If you navigate to another article and then return, the article will open at the point where you left off, not at the beginning.

  • Application version is now displayed in error details. This helps to quickly identify which version the issue occurred on and reproduce it faster.

  • Vulnerability fixes. Before releasing new versions, we now automatically check the libraries used for known vulnerabilities.

January 2026

Breaking change:

  • Catalog filtering by property value. Previously, the filter could be assembled from several properties of the «Flag» type, allowing articles to be selected based on the presence of these properties. Now, a single property is selected in the settings, and the catalog is filtered by its value. The «Flag» type is still supported and is suitable for the simple «show/hide» scenario. If you need to select options, use a property of the «One from the list» or «Several from the list» type. See the article for more details.

    Warning! There is no automatic migration.

    Properties of the «Flag» type that were used in the filter will not be merged into a single property of the «One from the list» or «Several from the list» type. To switch to the new scheme, create a new property, add all the required values to it, and assign them to the articles and paragraphs.

  • Gramax Enterprise Server:

    • Service consolidation. We have merged the git-proxy, enterprise, and sso services into a single image, and drawio, plantUML, and diagram-renderer into another one. As a result, deployment has become simpler: now it requires 2 containers instead of 6. To update, please contact us — we will help you quickly reconfigure your environment.

    • Search queries report. A new Search Queries report has been added to the administration panel under the Metrics section. The report includes a graph, summary metrics in cards, and tables showing query statistics and a list of articles with search-driven visits. Data can be filtered by date and user, and you can select a specific time period.

  • Lazy loading of LFS objects. We have improved LFS functionality by adding lazy loading for LFS objects — now they are downloaded only when needed.

  • File previews. The reader portal now supports previews of PDF and DOCX files with a simple click. Readers no longer need to download a file to their computer — they can view it directly in the browser.

  • Advanced mode. The publication window now allows you to hide detailed information about added/removed lines and article resources using the Advanced Mode button. This simplifies viewing and speeds up the review process before publication.

  • Migration from the old PDF export to the new one. We previously released a new PDF export feature, which was considered experimental for several months. Now it is fully integrated and no longer requires manual activation — the new PDF export is available as part of Gramax’s core functionality.

December 2025

  • Gramax Enterprise Server:

    • Metrics module. Metrics for page views, visits, and visitors have been added to the documentation portal. In the Administration panel, the data is available as a chart. You can filter by date and users, and select a period (day, week, month). The module is enabled via Space  →  Modules.

    • Unsaved changes warning. When switching between tabs in the Administration panel, a warning about unsaved changes now appears to prevent loss of edits.

    • CSS styles editor. On the space tab, in the CSS styles section, an Edit button has been added. Styles open in a modal window with the Monaco editor, where they can be modified and saved.

    • Rename user groups. You can now rename user groups on the User groups tab.

  • Properties on the documentation portal. Previously, properties were displayed only in the application. Now you can configure their display on the Documentation portal. Readers will see them in the article and can use them to filter results in the search bar.

  • Links between catalogs. Support for adding relative links to articles in other catalogs has been implemented.

  • Git LFS support. Support for working with large binary files (images, archives, PDFs, etc.) via the Git LFS specification has been added.

  • Article and catalog menus. Buttons in the article and catalog dropdown menus have been grouped for easier navigation.

  • Comment closure warning. If you start typing a comment and then click outside the comment area, a warning will appear stating that the comment will not be saved.

  • UI refresh. We continue to update the Gramax interface. This time, we have improved the following components:

    • The editing panel has been unified in appearance.

    • The comments window has been updated.

    • In storage connection and source import, tabs have been replaced with a dropdown list.

  • Delete a merge request. You can now close a merge request in the Gramax UI — it will be deleted for all users after changes are published.

  • Comment history. It is now easier to track comment updates in the changes view: an icon appears on the left to indicate that comments have been added or modified. You can also click on a comment there, open it, and edit it.

November 2025

  • Gramax Enterprise Server:

    • Access management for catalog owners. Inside a catalog, you can now grant editing permissions to colleagues without going to the administration panel.

    • Search in attachments. The search now covers not only article content but also the content of PDF and DOCX files.

  • GitVerse integration. You can now use GitVerse as a repository backend.

  • Search improvements:

    • New ranking. Higher weight is given to results where the search term appears in the article title or in one of the headers.

    • Jump to the search phrase. After clicking a search result, the article opens at the fragment containing the search query.

    • Search results tuning. You can specify search queries for an article: if a user enters one of them in the search, the article will appear higher in the results.

    • Search by properties in the application. If properties are set on articles, you can filter search results by them in the search bar.

    • Improved results appearance. The results now indicate the catalog containing the match and display the header hierarchy for the article.

  • Pinned table header row. If a table has a header row or header column, it remains visible while scrolling.

  • Updated catalog settings UI. Settings are now grouped by topics for easier management.

  • Export improvements. We have enhanced the DOCX and PDF export settings. For example, you can now explicitly specify whether each header should start on a new page.

  • Move articles between catalogs. You can move an article or a section to any other catalog loaded in the current space within the application.

  • Move catalogs between spaces. You can move a catalog to any other space created in the application.

  • New home page in the application. We have improved the visual design and added clearer hints.

October 2025

  • Gramax Enterprise Server:

    • Knowledge testing. We have implemented a reader knowledge assessment module: you can now add a test with various question types to an article. After completion, user statistics will be displayed in the administration panel. To enable this feature in Gramax Enterprise Server, please contact us.

    • Administration panel in the application. The administration panel now appears overlaying the main application page rather than in a separate tab.

    • New catalog access settings interface. All users with catalog access are now displayed as a single list showing their roles. Separate tabs are available for group‑based access settings and external reader configuration.

    • Read access for all company employees. You can now assign the Authenticated group as readers for a catalog — all users who log in to the portal with their account will be able to view this catalog.

    • Settings update parameter configuration. By default, editors receive any changes made in the administration panel every 10 minutes. This parameter can be adjusted — for example, you can set synchronization to occur every 3 minutes.

    • Desktop version synchronization with the documentation portal. To ensure editors and readers have the same set of Gramax features, we have synchronized versions across the application, documentation portal, and Gramax Enterprise Server.

  • PDF export templates. You can now configure CSS styles for PDF export. These styles are applied when exporting via the Gramax interface and in CI/CD. Available when experimental features are enabled.

  • Copying text with comments. When you copy text that includes comments, the comments will also be transferred when pasting into another article.

  • Performance improvements and stabilization. We have significantly accelerated the left panel in the catalog: articles now open, create, and move faster.

September 2025

  • File preview. Now, when you click on an uploaded file in an article, a preview window opens. DOCX and PDF files are displayed; other formats are downloaded.

  • Gitea support. We have expanded the list of supported Git repositories: you can now easily connect to Gitea and use all the application’s features. See the article for more details.

  • PDF export settings. Before exporting, you can customize the document’s appearance: add a title page, table of contents, and header numbers. We have also improved the export process so that the final document matches the article in the interface. Available when experimental features are enabled.

  • New features for static sites. The latest version of Gramax CLI supports: deployment to a subdirectory, a custom 404 page, style customization, indexing, metrics collection, logo configuration.

  • Home page changes:

    • Number of catalog changes. Tiles now show how many changes are stored locally and how many are available for synchronization.

    • Catalog deletion. You no longer need to open a catalog to delete it — you can do this directly from the home page.

  • Improvements and stabilization:

    • New menu design. We continue to update the Gramax interface. This time, we have improved the appearance of all menus, including catalog settings, repository addition, property configuration, and more.

    • Broken catalog recovery. If a catalog becomes corrupted, a window will appear offering to either delete it or reload it.

  • Gramax Enterprise Server improvements:

    • Deployment via Helm. We have added a new method for deploying Gramax Enterprise Server.

    • Preservation of loaded catalogs on login/logout. Previously, all catalogs except the base ones were removed when exiting the browser version of the application. Now, each editor’s loaded catalogs are preserved.

    • Login/logout in the administration panel. We have added an authentication form so you can keep the administration panel as a browser tab.

    • Stability during concurrent workspace owner activity. Concurrent changes made by different workspace owners are now handled more reliably, reducing the likelihood of conflicts and lost settings.

    • Direct links to tabs. You can now save and share links to specific tabs in the administration panel.

August 2025

  • Section display on the home page. In the previous version, we improved the home page appearance, but catalogs could only be grouped into folders. The new version introduces the «Sections» grouping mode: the home page now displays the section name and its contents. A section can contain catalogs and other folders.

  • Table styles in corporate DOCX templates. We have added table style configuration options.

  • Image alignment with text wrapping. You can now configure image alignment and text wrapping.

  • Interface language synchronization with documentation language on static sites. If multilingual support is configured for a catalog, readers on the static site will switch the Gramax interface language when they change the documentation language.

  • Experimental features for the documentation portal. You can now enable Gramax experimental features on the portal. See the article for more details.

  • Improvements and stabilization:

    • New PDF export. We have revised the PDF export logic. While no new features have been added yet, this mechanism will allow us to introduce pre‑export document customization in the future.

    • Comment improvements. You can now add comments to inline images and icons in an article.

    • New look for pop‑up windows. We continue to update the Gramax interface. This time, we have improved the appearance of several pop‑up windows, such as the catalog settings window, error checking window, and others.

    • Git command stabilization. We are continuing to stabilize interactions with Git repositories.

July 2025

  • Static site in the Gramax cloud. Now you can publish your documentation in just a couple of clicks — no server or hosting is required. Simply click «Publish to the cloud» and log in with your email account.

  • Content filtering. You can now create articles and paragraphs for different builds within a catalog. On the reading portal, they will be filtered using a toggle switch. See the article for more details.

  • Browser version on mobile. The Gramax browser version is now fully usable on mobile phones. All actions available on a computer are also supported.

  • New home page. We have improved the visual design of the home page. We have also added the ability to create nested groups. Catalog grouping is set at the space level. See the article for more details.

    If you have customized styles for your space, please verify that they display correctly on the new home page.

  • AI‑powered speech transcription. If AI features are enabled in your space, editors can now automatically transcribe audio recordings into text.

  • Viewing changes after synchronization. After synchronization, a revision comparison window now opens automatically, showing the differences between the new catalog version and the pre‑synchronization version.

  • Text highlighting. We have added the ability to highlight text.

  • Layout blocks inside other blocks. We have partially lifted the restriction on nesting blocks within each other. Now you can add notes to lists, tables to notes, and so on.

  • Comment improvements. You can now add comments to multiple paragraphs and to any block (image, diagram, etc.).

  • Catalog export to ZIP in the browser. Since browser‑based data is stored in an internal file system with no direct access, editors previously couldn’t download it. Now you can export a catalog to ZIP — the entire repository (articles and files) will be downloaded to your computer.

  • DOCX export in corporate templates via CI/CD. We have added the ability to export DOCX files using custom templates via Gramax CLI.

  • Change viewing modes. Before publishing, you can review changes in various modes: visual comparison, markup, dual‑pane, or single‑pane view. You can also undo changes individually, rather than for the entire article.

  • Desktop version update. We have improved the visual design of the update notification banner.

  • Experimental features. We have made the experimental features toggle more user‑friendly and intuitive: you can now select which specific features to enable within the application.

June 2025

  • Experimental features enabled by default. Experimental features are now enabled in the application by default:

  • Revision comparison. You can now compare the current catalog version with any of its previous versions.

  • DOCX export with corporate templates. We have added the ability to upload a corporate DOCX template and export articles and catalogs using this template.

  • Inline images. You can now insert images directly into the text line — for example, interface button images .

  • Favorites. You can mark catalogs and articles as Favorites for quick navigation. This is available both in the application and on the documentation portal:

    • Favorited articles are displayed within the catalog itself.

    • Favorited catalogs appear at the top of the home page.

  • Unified properties in catalogs and templates. We have enhanced the template mechanism: now you can use catalog‑wide properties as fillable fields. Additionally, articles created using a template can be displayed in views.

  • Related articles. From the article menu, you can view: where the article links to, which articles link to it.

  • HTTPS and diagram rendering configuration in the browser app on a custom server. We have updated the documentation to include instructions for configuring HTTPS and diagram rendering in the browser version.

  • Catalog path configuration for static sites. We have added the ability to specify the path where the static documentation site will be accessible. See the article for more details.

  • Interface improvements. We have introduced a new login form for Gramax Enterprise Server and a revamped Markdown editor.

  • AI feature integration. We have enriched the Gramax Enterprise Server image with AI features: text search and text editing.

May 2025

  • Templates. Added the ability to create templates with properties and use them in articles. Read more in the article.

  • Notes. Now you can save ideas and suggestions for documentation changes directly in the catalog. Notes are saved in the repository but are not displayed on the Documentation portal.

  • Enhanced Snippet Editor. Snippets can now be formatted like regular articles without restrictions. Read more in the article.

  • XML and Flavored Markdown for Source File Storage. Added two additional formats for storing articles. You can change the format in the Configure catalog.

  • Uploading Custom Icons in the Interface. To upload icons, you no longer need to go to the storage — they can be added in the Configure catalog. Read more in the article.

  • Quick Copy of Article Link. Now, when clicking on Share Article, you can select Do Not Show Again — the link will be copied to the clipboard immediately upon clicking from the article menu.

  • Improvements to the Merge Request Mechanism:

    • Changes in the request are displayed more clearly.

    • Comments are shown not only on the reviewer's name but also on the articles within the request.

  • Login for External Users in Gramax Enterprise Server. Added the ability to configure login to the reading portal via email: such readers do not need an SSO account. Simply enter your email during login and input a one-time code.

  • Stabilization and Acceleration:

    • Catalog loading in the browser application works stably, even if multiple tabs are open.

    • Changes in the publication window are collected and displayed faster.

    • Catalog synchronization has been accelerated for a large number of incoming changes.

    • Added detailed Git error handling: it will now be easier to identify the cause of issues.

  • Improved Branches Panel:

    • You can delete a branch from the application and repository using the icon.

    • Switch branches by simply clicking on their names.

  • Updated Appearance of Pop-ups and Settings. Improved the appearance of pop-up windows: catalog settings, articles, sections, and warnings.

April 2025

  • Catalog Logo Load in the Interface. You can now upload a catalog logo directly from the catalog settings — for both light and dark themes.

  • Spell Check on macOS. The desktop app for macOS now automatically enables the built-in SpellCheck engine. You can disable it if needed.

  • Note Type Selection in the Editing Panel. Before inserting a note, you can now choose its style directly in the editing panel.

  • Image Resize Panel Improvements. The appearance of the image resize border and sliders has been improved.

  • Documentation Portal Logs. The instructions have been updated to show how to view portal logs.

  • Loading Existing Catalogs. If you try to load a catalog that already exists in the app, it will now open automatically instead of duplicating.

  • Squash Merge Support. Previously, Gramax only supported standard merging — each commit remained separate. Now, you can choose «Squash commits» to merge all changes into a single commit.

  • Expired Token Indicator for Git-storage. If a repository token has expired, the storage is now retained and marked with an icon . Clicking it will prompt you to enter a new token or reconnect.

  • Improved Git Error Handling. Git errors in the browser version are now more informative, helping users better understand and resolve issues.

  • Performance Improvements. Git operations and article drag-and-drop actions in the left panel now work faster.

  • Security Updates

    • Updated all core libraries.

    • Disabled the unsafe mode for HTML components. HTML blocks must now be inserted via iframe only.

March 2025

  • Loading a Public Repository. You can now specify a link to any public repository and load (clone) it into Gramax. After clone, the original repository is not linked, but you can publish the catalog to your storage.

  • Deleting a Storage from the Interface. A Delete Storage button has been added. Useful if an access token expires or the storage is no longer needed.

  • Connecting a Storage with a Password. If a Git service is used as a storage without a personal access token, you can now connect using a login and password. Read more in the article.

  • New Table Appearance. Borders have been added to tables and table view.

  • Default Language for the Documentation Portal. When deploying a documentation portal, you can now set the default language to either Russian or English. Read more in the article.

February 2025

  • Branch Management Panel. Click the current branch name to open a pop-up that lets you handle branches without interrupting the rest of your work.

  • Updated Action Placement in Articles and Catalogs. The right panel now contains only article navigation and custom action buttons. Additional catalog actions have been moved under the icon, along with article actions.

  • New Code Block Languages. Added syntax highlighting support for Dart, Dockerfile, Erlang, F#, Groovy, Haskell, Julia, MATLAB, Nginx, OCaml, Scala, and TOML.

  • Catalog Loading Status. The homepage now displays the loading progress of a catalog (clone) and allows users to cancel the process at any time.

  • Improved PDF Export:

    • You can now export an entire catalog.

    • The exported PDF now includes view elements such as a table of contents for sections.

    • Screenshots now retain all borders and annotations set in the Gramax interface.

  • DOCX and PDF Export in CI/CD. Gramax CLI now supports generating catalogs in DOCX and PDF formats within CI/CD pipelines.

  • Images and Diagrams in Lists. You can now add images and diagrams to list items.

  • Full-Screen GIFs. GIFs can now be expanded to full-screen mode, just like images.

January 2025

  • Aggregation in Tables. Simply add a summary row or column to total up your data-like summing all cell values. Read more in the article.

  • Updated Table Editing Interface. We’ve redesigned the table-editing interface with a new control panel. Now, all the tools sit right on the table instead of in a separate bottom bar. You can also choose how to align your content-like left-align for a cleaner look.

  • Focus Between Two Blocks. You can place the cursor exactly where you need it-even between two blocks, like an image and a table.

  • Inserting Lists and Markdown from Clipboard. When inserting Markdown text into an article, the formatting is applied immediately. If you paste lists with nested items, the structure will be preserved.

  • Error Checking for Markdown Structures. A new Syntax Errors block has been added to the error checking feature. You can now check if all articles are displayed correctly.

  • Improved PDF Export. We’ve streamlined the export process, so you no longer have to go through a print window. Now you can export any section or article directly-no extra steps, no pop-ups. It’s faster, simpler, and gets you what you need in just a click.

  • Running Browser Version on Your Own Server. Run the browser-based version on your own servers. We’ve added the option to deploy the app.gram.ax browser app within your corporate environment.

  • Gramax Enterprise Server:

    • Catalog Owner Role. In the admin panel, the space owner can now assign an owner for each catalog. The catalog owner has access to:

      • Changing catalog settings.

      • Managing editors and approvers in the admin panel.

      • Managing the catalog on the documentation portal (branch switching, synchronization).

    • New Admin Panel Interface. We’ve improved the appearance of the admin panel and made working on each tab more user-friendly.

  • Beta Testing Access. A new Experimental Features option has been added to the main page of the app. When enabled, new features we are still working on will be available.

  • Chatbot for Issue Reports. Now, when you click Report an Issue in the error window, you will be redirected to our Telegram chatbot. This will help us address issues more quickly.

November 2024

  • Documentation Portal as a Static Site. You can now deploy your documentation portal not only using Docker but also as a static site. Read more in the article.

  • Application and Documentation Portal Styling. The new version lets you customize application and portal styles independently and publish them to your documentation portal. Learn more here.

  • Analytics with Matomo. You can now track your documentation portal analytics using Matomo. Details in the article.

  • Notion Import. Seamlessly transfer all your content from Notion into Gramax. Learn how to do it here.

  • Enhanced Properties Mechanism. We've added new properties and streamlined the interface for managing them. Find out more.

  • Viewing Directories Without System Files. You can now view MD files in Gramax even if they lack a title. These files will be grouped by folder names instead of relying on _index.md.

  • Navigation Buttons in the Desktop App. We’ve added «Back» and «Forward» buttons to the desktop application for easier navigation.

  • New Toolbar for Block Elements. The additional toolbar for block elements like notes, images, code blocks, and diagrams has been relocated to improve usability.

  • Lazy Loading for Images. Images in both the application and portal now load more smoothly, ensuring better performance and user experience and paragraphs.