Release Notes

​

4.0.0-rc5

• New date format helper function replaceLegacyDateTimeFormats(data, formatReplacementsObject) to allow overwriting default US date and time formats within the Joyfill SDK. See the example below or check the README.md for more details. (NO-1622)

• Replaced Moment.js with Day.js — Reduces bundle size and provides better long-term maintenance support. (NO-1623)
• Enhanced validation output — Form and field validation statuses now include the pageId property, making it easier to identify which page an error is on. You can view this in the output of the validator.validate helper function. (NO-1628)

• PDF generation edge case — Resolved an issue where the field measuring cycle could run indefinitely for certain table field input types in the VanillaJS module. (NO-1647)

• Legacy RTE field — The old Rich Text Editor field is now view-only but continues to display all previously saved text. It can be replaced with the newer Block field, which removes a package vulnerability, reduces bundle size, and improves load performance. (NO-1648)

​

Replacing Default US Date Formats

/**
 * Example: Replace US date/time formats with European formats in JoyDoc
 */
let updatedDoc = <YOUR_JSON_DATA>;

if (Intl.DateTimeFormat().resolvedOptions().timeZone === 'Europe/London') {
  updatedDoc = replaceLegacyDateTimeFormats(updatedDoc, {
    dateTime: "DD/MM/YYYY HH:mm",
    date: "DD/MM/YYYY",
    time: "HH:mm",
    defaultFormat: "DD/MM/YYYY"
  });
}

console.log(JSON.stringify(updatedDoc, null, 2));

​

4.0.0-rc4

• New date/time element for all date/time fields and columns.
• Support for optional custom date/time formats to provide consistent behavior across time zones and browsers.
• This update addresses long-standing inconsistencies between local time zones, browsers, and native date/time input behavior. (NO-1574)

• Crash affecting tables on PDF Forms and PDF Forms rendered in Microsoft Edge. (NO-1543)
• Issue where underlying table cell formulas were appearing in generated PDFs. These cells will now display as empty. (NO-1452)
• Issue where chart field line point labels were duplicated, causing a blurring effect. (NO-1575)

​

🗓️ New Date/Time Element & Custom Formats — Details

​

📌 Visual Impact of Removing Native Browser Date/Time Inputs

• Existing saved formats (MM/DD/YYYY, MM/DD/YYYY hh:mma, hh:mma), or
• Your explicitly defined custom format.

​

🛠️ Custom Format Usage

// Field Settings
{
  field: {
    customDateTimeFormat: true, // Enable for date/time field
    tableColumns: {
      customDateTimeFormat: true, // Enable for date/time columns
      ...
    },
    ...
  },
  ...
}

​

📱 Native Mobile SDKs

Important: If you’re using the native iOS, Kotlin, or React Native SDKs, it’s recommended to keep custom date formats disabled for now. Custom formats are not yet fully supported across Joyfill’s native SDKs and may cause unintended behavior.

​

3.19.7

• Maximum depth call exceeded crash when tables are added to PDF forms.

​

3.19.6

• Support for Hidden Table Columns — Hidden columns within collection fields are now fully supported and integrated, offering greater control over field layout without impacting functionality. (NO-1202 / JF-58)

• Conditional Logic Reliability — Misc enhancements to conditional logic making it consistent and more reliable. (NO-1187)
• Block Column Type Configuration — Block column types within collection and table fields can no longer be marked as required, aligning with expected usage patterns and improving form design flexibility. (NO-1186)
• Rich Text Editor in Fill Mode — Rich Text Editor (RTE) fields are now fully editable while in fill mode, enabling more seamless data entry without requiring additional steps. (NO-1180)

• Hidden Columns and Validation — Resolved an issue where hidden columns in collection fields were incorrectly triggering validation errors. Hidden fields are now excluded from validation unless explicitly required. (JF-58 pt2)

​

3.19.5

• Misc bug fixes.

​

3.19.4

• Misc PDF bug fixes.

​

3.19.3

• Misc bug fixes.

​

3.19.2

• Misc bug fixes.

​

3.19.1

• Misc bug fixes.

​

3.19.0

• New enhancements to the Table field.

• Improved page breaking in PDF exports for dynamic fields.

• Bug fixes and enhancements.

​

3.18.1

• Misc bug fixes.

​

3.18.0

• Tree Structure v1 (NO-689) — A powerful new way to organize hierarchical data with nested data representation, expandable/collapsible nodes, and improved performance for complex structures.

• Image Upload Experience (NO-990) — Fixed various issues to improve the reliability and performance of image uploads.
• Validator Fields Sorting (NO-985) — Validator fields now appear in the correct order based on their position on the page.

​

3.17.0

• Image Field Resizing (NO-946) — Miscellaneous improvements to ensure proper image scaling.
• Display Text (Block) Enhancements (NO-838) — Improved behavior and display of block elements.
• Android Upload Experience (NO-948) — Enhanced image/file upload functionality on Android devices.

• Table Text Column Editing Bug (NO-940) — Resolved an issue with text column cells not editing properly.
• Custom Icons (NO-970) — Custom icons now correctly render within field groups in the field list.
• Multi-line Text in PDFs (NO-957) — Adjusted text measurement to prevent content from being cut off in PDF exports.
• PDF Export Table (NO-949) — Fixed an issue where tables were cutting off bottom rows when spanning across page breaks.

​

3.16.0

• Full-width Min/Max inputs for chart field settings. (NO-814)
• Signature Field V2 (NO-680) — Enhanced signature field with improved design and functionality for seamless user experience.

• Performance Enhancements for Very Large Forms (NO-783) — Optimized performance for handling large-scale forms efficiently.
• Layout Engine Phase 1 (NO-578) — Improved PDF generation with better page-breaking for non-dynamic fields.

• Duplicate Field Bug (NO-832) — Resolved an issue with duplicate fields in horizontal display type for MultiSelect.
• Chart Coordinates (NO-764) — Addressed x and y label cut-off issues in chart coordinates.

• JoyDocExporter no longer defaults to sans-serif font family. You are now required to set the fontFamily by using the theme property. See SDK README.md for how to properly set the theme font family.
• JoyDocExporter now requires an initial measurement phase before PDF is ready to be captured. An element with .pdf-capture-ready will be added to the DOM when measuring is completed and PDF is ready to be captured.

​

3.15.1

• Field Duplication (NO-662) — Clone fields faster with our new duplication feature.
• Page Names In Page Navigation Bar (NO-657) — Page names now appear in the page navigation items.
• Custom Field Option Icons (NO-817) — Customize your field options with custom icons using SVG Components and image urls.
• New onSelect SDK Event (NO-762) — New onSelect handler to keep you in the loop every time a field is clicked.

• Formula Hide-and-Seek (NO-813) — Formulas on individual table cells fields properly handle formulas, staying hidden unless the field is focused.

• Signature Distortion (NO-822) — Signatures now look flawless, no matter the size of the field.
• Corrupted Table Data Crashing (NO-795) — Missing row.cells values within table field causing an SDK crash has been patched.
• Selection Fields Border (NO-761) — Checkbox and radio button borders are now visible at all times.

​

3.14.1

• Ability to re-order pages within the builder (NO-656)
• Confirmation modal for toggling mobile syncing (NO-653)
• Validation helper method. See README helper methods to learn more. (NO-677)

• Updated peer dependencies to support React version >18.0.0 (NO-684)
• Metadata field settings structure has been updated to follow consistent pattern (NO-684)

• Multiple UI fixes and bug fixes (NO-686, NO-647, NO-650, NO-679, NO-639)

​

3.13.0

• Validation helper (NO-579)
• Support to sort fields based on x and y coordinates inside conditional logic modal (NO-643)

• Bug that would make a field disappear when zIndex is set as the negative number (NO-644)
• Bug that would cut off field settings due to accordion height (NO-639)
• Filter out orphaned fields (ie fields without any field positions) from the Joydoc (NO-559)
• Style bug that cut off the field settings as a whole (NO-614)

​

3.12.0

• Enhanced mobile device responsive web forms (NO-592)

• Invalid JSON payload freezing SDK (NO-613)

​

3.11.0

• getDefaultPage helper method (#NO-604)

• Vulnerable dependencies (#NO-604)

​

3.10.0

• Loading indicator for image / file uploads (NO-298) — A new loading indicator lets you know exactly when your images and files are being uploaded.
• Support for scaling pdf background images (NO-470)

• Updated JS SDK Internals (NO-528)
• Enhanced table column settings (NO-352)

​

3.9.1

• Transparent color support to the Settings Color Picker (NO-451) — Now you can create designs that are truly see-through.

• Adjust height of field scroll selector (NO-522) — Prevents menu items of field identifiers from overflowing their wrapper.

​

3.9.0

• File Upload Field enhancements (NO-498) — Multiple files support, drag-and-drop, customizable styles, colors, and layouts, and conditional logic support.
• Enable/Disable Field Settings Options (NO-479) — You can hide any setting now by passing it as false in the field settings object.

• Default values for table columns (NO-499) — Your default values will now show up properly.
• Identifier Filter not clearing post search (NO-492) — Your search results will no longer be haunted by the ghosts of past searches.
• Page loading bug (NO-484) — Solved the mysterious loading indicator that haunted the Form builder after deleting the current page.
• “Exports is Undefined” (NO-494) — Fixed the missing “Exports” issue.

​

3.8.0

• Identifier Enhancements (NO-469) — You can now enable or disable custom identifier creation.
• Field margin control for a polished look (NO-433)
• Default page padding for a consistent design (NO-433)
• Read-only mode to make any field read-only by the read-only option on field settings (NO-433)

• Bug where the option width couldn’t be removed from multi-select fields (NO-459)
• Bug that caused the SDK to crash when encountering invalid JoyDoc payloads (NO-432)
• Identifier filter results not clearing after removing search query (NO-469)

​

3.7.1

• Developer-friendly SDK for PDF generation (NO-355)
• SDK Themes to elevate your forms (NO-396)

• Tidied up some errors for a sparkling console (NO-398)
• Improved performance for a smoother experience (NO-450)
• Revamped SDK for a stunning experience (NO-58)

​

3.6.1

• Crashes after Loading External Form (NO-395)

​

3.6.0

• Support for original file dimensions in PDF Form Engine (NO-349)
• Text wrapping for text based fields (NO-307)
• Field icon added to field settings (NO-315)

• Display corresponding field settings of individual table cells when focused (NO-310)
• Field wrapping doesn’t cut off text within pdf and pdf exports (NO-107)
• Hidden property causing validation issue in older SDK version (NO-377)

​

3.5.0

• Conditional logic (#NO-288)
• onFocus and onBlur event handlers now supported in SDK (#NO-223)
• Support for initialPageId on SDK for setting the initial page when the form is displayed (#NO-297)

• Enhancements to PDF exports (#NO-250)
• Enhancements to responsive web view for mobile form filling (#NO-252)
• PDF form view enhancements (#NO-279)
• Enhancements to required field indicators (#NO-295)

• Style fix for Identifier selector (#NO-278)

• Improved vanilla JS implementation for JS modules and CDN approach. See new implementation methods below (#NO-277)

<!DOCTYPE html>
<html>
  <head>
    <title>Joyfill for Javascript Example</title>
    <base href=".">
    <meta charset="UTF-8" />
    <script src=" https://cdn.jsdelivr.net/npm/@joyfill/components@latest/dist/joyfill.min.js"></script>
  </head>
  <body>
    <div id="joyfill"></div>
    <script>

      Joyfill.JoyDoc(
        document.getElementById('joyfill'),
        {
          mode: 'edit',
          onChange: (changelogs, doc) => console.log('onChange: ', changelogs, doc),
        }
      );

    </script>
  </body>
</html>

//index.html

<!DOCTYPE html>
<html>
  <head>
    <title>Joyfill for Javascript Example</title>
    <base href=".">
    <meta charset="UTF-8" />
  </head>
  <body>
    <div id="joyfill"></div>
    <script type="module" src="./index.js"></script>
  </body>
</html>

//index.js

import Joyfill from "@joyfill/components/dist/joyfill.min.js";

Joyfill.JoyDoc(
  document.getElementById('joyfill'),
  {
    mode: 'edit',
    onChange: (changelogs, doc) => console.log('onChange: ', changelogs, doc),
  }
);

​

3.4.2

• Chart field label read-only error in build.
• Misc enhancements and bug fixes.

​

3.4.1

• Identifier selector field customization. Learn more https://docs.joyfill.io/docs/customize-settings (NO-87)

• PDF dynamic field measurement enhancements (NO-113)
• Auto remove individual table cell field positions associated with deleted columns (NO-254)

• Misc enhancements and bug fixes.

​

3.3.1

• Page duplication support with page menu and duplicatePage helper method (#NO-95)
• Table field now supports image uploading directly to table image cells (#NO-114)
• Field tooltips now supported for additional field context and instructions (#NO-130)

• Misc enhancements and bug fixes.

​

3.2.0

• Joyfill template library UI and visual requirements support (#NO-17)
• Field groups display mode for table fields (#NO-17)
• Rich text field support (#NO-17)

• Table columns are responsive by default now (#NO-17)
• Multi image upload adds to current images and no longer overwrites them (#NO-149)
• Table field settings enhancements (#NO-163)

• Signature is properly scaled to fit within field dimensions (#NO-172)

​

3.1.0

• Multi-user collaboration support via changelogs.
• Changelogs are now passed directly to the onChange handler. See package README.
• Helper methods for generating and duplicating documents and templates: getDefaultDocument, getDefaultTemplate, getDocumentFromTemplate, duplicate. See package README.
• Field lazy loading. See package README.

• onChange argument list has been changed. onChange now only receives two arguments: changelogs and doc. See README.