• Texts

• Images

• Tables

• Columns

• Header / Footer

Initialize PDF document

Initialize your pdf document and set initial configurations

The first action you should use to start a document, it sets the initial configurations of your PDF Document:

1. Page size: sets the page size, according to the standard papers sizes accepted by PDF Make.

2. Page orientation: sets the page orientation, which can be horizontal (Landscape) or vertical (Portrait).

3. Set page custom margins: allows the use of custom document margins, if not checked, the margins used will be the ones that PDF Make uses by default

4. Margin left, top, right, and bottom: sets the value of the page margins in points (pt). If the option “Set page custom margins” is not checked, the values will be ignored.

Load font

Upload font files, if you want to use other fonts that are not available by default

1. Previous step result: Required to load the options from previous actions of this plugin in back-end workflows

2. Font name: The font name, that you will use in other actions, please avoid using special characters!

3. Font files: Regular, Bold, Italics, and Bolditalics. You can upload the font files or just copy the files links

💡

We recommend the use of TrueType font file extension (.ttf)

Default fonts that you don’t need to upload:

Roboto, Times New Roman, Courier New, and Helvetica

The PDF Make uses Roboto by default

Not all fonts can be read. If you have a text in Arabic, Chinese, etc., please experiment with the top fonts for these languages and see which one suits you best. For ex: For example, for a PDF in Arabic, you can use Amiri.

Add OR

The add QR action in pdfmarket.js allows you to insert a QR code into a PDF document. This action generates a QR code based on a provided string or URL and places it at a specified location within the PDF.

Add Watermark

The Watermark function in pdfmarket.js allows you to apply a watermark (text or image) to a PDF document. This watermark can be positioned on each page of the PDF, either as a visible overlay or background, depending on the configuration.

Generate SignURL

Generates a Signed Url

Add TOC

The TOC function in pdfmarket.js generates a Table of Contents that lists the sections of the PDF document. It facilitates quick navigation through the document by providing users with a clear structure of the content.

Add image

Draw images into the PDF document

1. Previous step result: Required to load the options from previous actions of this plugin in back-end workflows

2. Image name: The name that will be used to reference the image, if you want to use it again

3. Has the image already been used?: Check if you have already used this image in a previous action in the same workflow. This way just enter the same name as before without having to upload the image again

4. Image: Upload the image or copy the image link. It is required if you have not used the image before, you also can use an external source to find a free image!

5. Width: set the image width

6. Height: set the image height

7. Image alignment: choose the image alignment (left, center, or right)

8. Use custom margins: check if you want to use extra margins in your image element

9. Margins left, top, right, and bottom: set the value of the margins in points (pt). If the option “Use custom margins” is unchecked, the values will be ignored

10. Page Break: choose if you want or not to add a new page, after or before the element

11. Is this element being put into a Multi Column?: check if you want to put the image into a multi-column structure. Each image element will occupy one column of the structure! Do not forget to start a multi-column structure before (through the “Start multi column on PDF” action)

12. Multi column name: the multi-column name defined into the “Start multi column on PDF” action, must be exactly the same inputted there.

13. Column Width: choose if the column will fit the content or will occupy the available space

14. Is this element being put into the header?: Check if you want to put the image in the page header. Do not forget to activate the document header (through the “Activate header on PDF” action)

15. Is this element being put into the footer?: Check if you want to put the image in the page footer. Do not forget to activate the document header (through the “Activate footer on PDF” action)

16. Is this element being put into the background?: Check if you want to put the image in the page background.

17. Structure name: the repeated structure name defined into the “Start repeating structure on PDF” action, must be exactly the same inputted there. Use it if you want to put the image element into a repeating structure

18. Image list: A image URL list that you want to insert into a repeating structure. Each image will be placed into a different structure inside a repeating structure. If you leave this field empty, the image selected before will be placed into each structure instead.

💡

If the height and width values are not set, the image will be kept at its original size.

If only the width value has been set, the height will be adjusted to maintain the original image scale.

If only the height is defined, the width will be kept the original of the image.

If the image size is larger than the size it can occupy, the image may be cut off or not appear (especially in columns or in the header/footer), so adjust its size until it appears correctly.

Add table

Draw tables from a list of things

1. Previous step result: Required to load the options from previous actions of this plugin in back-end workflows

2. Body text style: the style name defined into the “Define new style to PDF” action, must be exactly the same inputted there. this style will be defined for the body of all columns

3. Table column width: choose if all table columns will fit the content or will occupy the available space

4. Create header row in this table?: Check if you want the first row of the table to be a header, if the table takes up more than one page the header will be repeated on all pages

5. Header text style: the style name defined into the “Define new style to PDF” action, must be exactly the same inputted there. this style will be defined for the header of all columns

6. Table layout: Choose the table design that you like best. They will be displayed below.

7. Use table custom margins: check if you want to use extra margins in your table element

8. Margins left, top, right, and bottom: set the value of the margins in points (pt). If the option “Use table custom margins” is unchecked, the values will be ignored

9. Page Break: choose if you want or not to add a new page, after or before the table element

10. Column’s header (1 to 20): the respective column header label, if you do not check the option “Create header row in this table?”, Its content will be ignored, on the other hand, if you leave this cell blank and check the option, the cell will be blank

11. Column’s body (1 to 20): a list of text that fills the table column, each text will be a table line

12. Use column (2 to 20): Check if you want to use the respective column, if not checked the column content will be ignored

13. Is this element put into a Multi column?: check if you want to put the table into a multi-column structure. Each table element will occupy one column of the structure! Do not forget to start a multi-column structure before (through the “Start multi column on PDF” action)

14. This Column’s Width: choose if the column of multi-column structure (NOT the table column) will fit the content or will occupy the available space

15. Multi column name: the multi-column name defined into the “Start multi column on PDF” action, must be exactly the same inputted there.

16. Is this element being put into the header?: Check if you want to put the table in the page header. Do not forget to activate the document header (through the “Activate header on PDF” action)

17. Is this element being put into the footer?: Check if you want to put the table in the page footer. Do not forget to activate the document header (through the “Activate footer on PDF” action)

18. Is this element being put into the background?: Check if you want to put the table in the page background.

Start Multi-column

Use to create a multi-column structure in your document, you can add columns to it through the actions: add texts, images, and tables! Each element will be a new column, so if you want, for example, a text with two columns you need to use de action “Add text on PDF” twice

1. Previous step result: Required to load the options from previous actions of this plugin in back-end workflows

2. Multi column name: The multi-column name, that you will use in other actions, please avoid using special characters!

3. Columns gap: the space between the columns in points (pt)

4. Page break: choose if you want or not to add a new page, after or before the multi column structure

5. Being repeated: set “yes” if the multi-column will be inserted into a repeating structure

6. Repeating structure name: the name of the repeating structure you want to place the multi-column into.

💡

If you want to place the multi-column into a repeating structure, the plugin will create a different multi-column for each structure inside the repeating structure, ideal for use with a list of things in actions like add text, and images, because each element in the list will be inserted into a different multi-column! To do that just combine the options to use multi-columns and repeating structures in these actions (add text, and add image)

End Multi-column

Use to end a multi-column structure in your document, and insert it into the document or into a repeating structure

1. Previous step result: required to load the options from previous actions of this plugin in back-end workflows

2. Multi column name: the multi-column name defined into the “Start multi column on PDF” action, must be exactly the same inputted there.

3. Being repeated: set “yes” if the multi-column will be inserted into a repeating structure, must be the same choice that you set in the “Start multi column on PDF” action

4. Repeating structure name: the name of the repeating structure you want to place the multi-column into. Also must be the same choice that you set in the “Start multi column on PDF” action

Active footer

Make it possible to insert content into the document footer

1. Previous step result: required to load the options from previous actions of this plugin in back-end workflows

2. Show page number? (counter): check if you want to put the page number into the footer

3. Start count on second page: check if you want that the counter starts on the second page. The counter will be hidden automatically on the first page, and the second page turns the number 1

4. Even and Odd pages counter alignment: choose where the counter will appear in the respective page number (left, center or right)

5. Hide page numbers (counter) on specific pages?: check if you want to hide the counter on one or more pages, but the count will not be changed

6. Hide counter on: the numbers of the pages you want to hide the counter, separated by a comma.

7. Hide header elements on specific pages?: check if you want to hide the footer elements on one or more pages

8. Hide elements on: the numbers of the pages you want to hide the footer elements, separated by a comma.

9. Left, top, right, and bottom page number margins: the margins of the number counter element

💡

Remember that if you have chosen to start counting on the second page, the number of pages will be counted from that. Please consider this when choosing the pages where the elements or the counter will not appear, because the first page will be number 0.

💡

Footer space is limited, so if any elements don't appear then resize them to fit

Start repeating structures

Initialize a repeated structure into the document ideal for some label that repeats yourself or a list of things that have the same structure

In this action, the plugin creates many structures that you want inside the repeating structure!

In other words, these structures, that the plugin creates, are simple lists, that you can insert things on, like texts, images, columns, and tables

You can put the same element in all these lists or when you pass a list of things, each element goes into a different list inside the repeating structure

1. Previous step result: required to load the options from previous actions of this plugin in back-end workflows

2. Name: The repeating structure name, that you will use in other actions, please avoid use special characters!

3. How many structures: the number of structures (or lists) that you want to put inside this structure

End repeat structure

Insert the repeated structure into the document.

1. Previous step result: required to load the options from previous actions of this plugin in back-end workflows

2. Name: The repeating structure name that you entered in the action “Start repeating structure on PDF”

Start repeated table

Start a repeated table structure in your document, ideal for some lists of data that have the same structure, for example, a list of couples: each couple has a list of the names, ages... of each person, so each couple will be a table, and the properties (name or age) will be the tables' columns.

1. Previous step result: required to load the options from previous actions of this plugin in back-end workflows

2. Table name: The repeated table structure name, that you will use in other actions, please avoid use special characters!

💡

You need to start a repeated structure before initializing a repeated table

Start advanced table

Use to create an advanced table structure, it is similar to a regular table, but you can add as many columns as will fit in your document and style them individually

1. Previous step result: required to load the options from previous actions of this plugin in back-end workflows

2. Table name: the advanced table structure name, that you will use in other actions, please avoid using special characters!

Conjure PDF(server-side)

Use this action to generate the resulting PDF document, it will return the document on a base 64 string format as the content, and the file name with the PDF file extension (.pdf)

1. Previous step result: required to load the options from previous actions of this plugin in back-end workflows

2. File name: the PDF file name, it will be added into the document metadata as the title

3. Set data header: check if you want to add the data header into the base 64 string, we use the data header to open the document into a browser (the base 64 string will start with “data:application/pdf;base64, ...”)

Conjure PDF(client-side)

• File name

• Save in File Manager

• Attach PDF to - his field specifies whether the generated PDF should be attached to another document or entity within the application (e.g., a user profile, order, or report).

• Disable browser download

• Save to AWS

• Pressing URL

Upload PDF

Use this action to upload the resulting PDF via a back-end workflow, but you need a API Workflow that receives a file type field. This action returns the uploaded file URL

1. Upload file URL: the URL of your API Workflow that uploads the file to the Bubble server (see next page for more details)

2. File input name: the input name that receive the file (file type) in you API Workflow

3. File name: the result of the action “Conjure PDF” File name

4. Content: the result of the action “Conjure PDF” Content

5. Authentication: if the upload API Workflow needs a authorization token (the API key or a token provided by a authentication API Workflow)

6. Save In AWS - The Save AWS checkbox is a UI element that indicates whether the data should be uploaded to AWS (Amazon Web Services). When this option is checked, the system will upload the relevant files or data to an AWS storage service (such as S3). If unchecked, the data will not be saved to AWS.

7. Bucket Name - The Bucket Name field specifies the name of the AWS S3 bucket where files or data will be stored. An S3 bucket is a logical container used for storing objects (files, metadata, etc.) in Amazon S3, and each bucket name must be unique globally across AWS.

1. Create a new App into your account and add the PDF Conjurer plugin

2. The server side actions only works into the Backend workflows, so just go to the Top Menu and open the

1. In the Backend workflows you can create a workflow like you want (if you have a paid plan), here we create a new API Workflow as example, so give it a name, and make the configurations that you need

2. Use the action Initialize PDF Document to set the initial

configurations of your PDF document

3. After the Initialize PDF Document action, insert the action that you want to add a content, you can use it in any order that you want

4. Remember to load the previous step result Configurations into the first field of each action

1. After the Initialize PDF Document (Not necessarily right after) action, insert the action that initialize the structure

2. The content must be between the start action and the end action of the corresponding structure, you can use these fields to specify where the content will be inserted, if none of these fields were used, the content will be inserted into the document

3. Remember to insert the end action, in order to insert the structure into the document, before the “Conjure PDF” action

4. Repeated tables must be inserted inside a repeating structure

5. You can also combine multi-columns with repeating structures, using both fields in the actions!

6. You can insert repeated tables into multi-colunms when this multi-column are into a repeating structure

1. Remember to use the activate header/footer on PDF action, you can use only one or both into your document:

2. The background doesn’t need to be activated

3. Insert content into these structures:
You can use the fields in an action to put the element into these structures

1. Use the action Conjure PDF

2. Set the last action into the first field

3. Set the PDF Document name

4. Choose if you want to insert the data header at the result base 64 string

• Returned from your API Workflow

• Saved into the database

• Uploaded it into the Bubble server through the action “Upload PDF” and an upload API Workflow (see next page)

1. Use the action Upload PDF in your workflow

2. Into field “Upload file URL” insert your Workflow API root URL plus “/your_upload_workflow_name”

3. Insert the key name that receive a file into your upload workflow into the field “File input name”

4. The “File name” field receives the “Conjure PDF” action File name result

5. The “Content” field receives the “Conjure PDF” action Content result

6. If you chose not that the workflow run without authentication, you need to insert the API token or a valid token provided by an authentication API Workflow into the “Authentication” field

Creating text or Inserting Image on a PDF Model threw the following error: TypeError: Cannot read properties of null (reading 'replace')

Actions like Create text or Insert image cannot be left as empty, if you use dynamic data expressions you need to make sure that Bubble doesn’t see them as empty, or else the plugin will throw errors because it doesn’t see what content to display.

You could check how Bubble sees your dynamic expression by launching your page in Step-by-Step mode and paying close attention to the Create Text/ Insert Images actions their dynamic data values shouldn’t be empty!

We suggest considering adding to all actions that rely on dynamic data to add content to your PDF final, to have a condition that will make it so that the plugin skips an action if it has empty data. You can find the screens attached in our previous reply

Example based on a Create text on PDFModel action:

​

You need to copy the expression and set a condition that will trigger only when the expression is not empty.

By setting it the following way the plugin will skip this action in case it has empty data, and will get to the next one without throwing errors.