(Beta) How to use the Marq Integration with HubSpot

Important
In order to use the Marq HubSpot app, you must have the HubSpot add-on  and at least a HubSpot professional subscription. If you would like to trial the integration, please submit a demo request. 

Quick start guide

Follow along in this video for a quick walkthrough on testing each of the features.

Installing the app

To install the Marq app card in HubSpot, you'll need permissions to be able to add integrations on behalf of your org. Follow these steps to proceed with installing the app:

  1. Log in to your Marq account.

  2. Visit the app marketplace and select the HubSpot app
  3. Connect and authorize the Marq app to your intended org in HubSpot.

  4. Authorize the Marq permissions within Marq.

Adding the Marq app to your records

To add the Marq app card in HubSpot, you'll need to add it to the UI in its specified location. For example, to add a card to the contact record view:

  • Log in to your HubSpot account.

  • In your HubSpot account, navigate to Contacts > Contacts. Then, click the name of a contact to view its record.

  • At the top of the contact record, click Customize tabs. A new tab will open showing the record editor sidebar.

    crm-recrd-customize-tabs

  • In the right sidebar, click Default view to edit the default contact record view.

  • For the purposes of this tutorial, click the + plus icon tab at the top of the editor to add a new tab. (Not a requirement - If you are unable to add a new tab, you can add the card to the "Overview" tab and skip this step)

    crm-record-page-editor-add-tab

  • In the dialog box, enter a name for your new tab, then click Done.

  • With the new tab added, click the Add cards dropdown menu.

  • In the right panel, under Card types, click Apps.

    Screenshot 2024-11-06 at 10.33.19 AM

  • Select the checkbox next to the Marq app.

  • Click the X at the top of the right panel to close it.

  • In the top right, click Save and exit.

  • Navigate back to the contact record, then refresh the page. You should now see your new tab, which will contain your new card. You can also do this with company or deal records. 

Authorizing the Marq app

Each user will be able to connect their own Marq accounts. When initially loading, they will see a "Connect to Marq" button 

Using the app

Once connected, the user who connected will see the brand templates that have been shared with them in Marq. If no templates are shared with the user or if no applicable filters are met for the template category, they will see a blank state. 

As the user creates from the templates in the "Relevant Content" table, a new table called "Created projects" will appear which will house the content they generated that is associated with the record it was generated from. 

The user can use the search bar which will pull in all templates and associated projects.

Saving a project

Projects will automatically be placed into the "Created projects" section once you've created them and will be uniquely associated with the record they were created in. 

For additional features such as using the file saved in HubSpot, click the "Save" button in the editor. 

Edit a project

Projects can be edited by clicking on them within the created projects section or by selecting More > Edit. Any changes you make will be saved to the Marq project. In order to update a file, be sure to click the Save button.

Copy link to a project

If a project has been saved, you can click on More > Copy Link for the public PDF.

Screenshot 2024-11-06 at 1.24.29 PM

Present a project

You can present the project by clicking the More > Present option. This will open a slide viewer mode of your project.

Screenshot 2024-11-06 at 1-24-37 PM-png

Download a project

If a project has been saved, you will be able to download it to your computer by selecting the More > Download option.

Screenshot 2024-11-06 at 1.24.50 PM

Convert a project to a sales document

If a project has been saved, you will be able to convert the project to a sales document by selecting the More > Convert to Sales Document option. This will act as a shortcut to take you to the documents section in HubSpot for you to convert your project. Click Upload > Select existing file in HubSpot and locate the project you saved. After you converted your project into a document, you can use it in 1:1 sales emails and track the engagement of the file.

Screenshot 2024-11-06 at 1.25.02 PM

Delete a project

You can delete a project from the HubSpot record by selecting the More > Delete option. The project will still remain in your Marq account but will remove all association to the record and you will be able to create and associate a new project from your templates.

Screenshot 2024-11-06 at 1.25.11 PM

To update settings, navigate to the App Marketplace in HubSpot and select Manage apps. Search for Marq and then select Actions > Go to Settings

Screenshot 2024-11-08 at 11.15.31 AM

  • Updating collaborating settings 
    Toggle this setting on to allow users to share projects to other users from within the embedded editor
  • Updating downloading settings
    Toggle this setting on to allow users to download projects directly from within the embedded editor 
  • Updating printing settings
    Toggle this setting on to allow users to print projects directly from within the embedded editor
  • Updating preferred export format
    Select an export format for the "Save" button to control what export format is sent back to your HubSpot record as a file
  • Set filters and data preferences
    Control how templates filter and populate data based off of the record values

Using template filters

Template filters allow you to serve up relevant content to the person working on the record so that they can choose templates that based on the record stage, industry, type, or any other type of configuration/preference.
 
To configure template filters, click on the Configure filter/data button > Configure Template Filters
By default, all templates shared with each user will populate into the card. To control which templates are served up, you can add filters that correspond to the value of your HubSpot properties and the Marq Template category filters. Select the left dropdown to add in the HubSpot field and the right dropdown to add in the corresponding Marq category field. The values associated to each HubSpot property and Marq category need to match up exactly in order to pull in the relevant templates that meet the filter criteria.
For example:
  • HubSpot: dealstage (Value = Opportunity strategy)
  • Marq: HS deal stage (Value = Opportunity strategy)
Because the value of "Opportunity strategy" matches on both HubSpot and Marq, it will bring in templates assigned to those filters.  If you update the property value in HubSpot, the templates will automatically refresh and filter to the new values.

Using smart fields

Smart fields are dynamic fields and images within Marq templates that allow data to auto-apply from HubSpot.
To configure smart fields, click on the Configure filter/data button > Configure Smart Fields
Screenshot 2024-11-08 at 11.40.11 AM
Adding text and image fields
Click on a relevant object and add the fields you want to create smart fields for. Text fields will support any text based field type while an Image field will support a public file type field in HubSpot.
Important: The image field type needs to be a public file type. To create a field with a public file type, go to your object properties > create/edit > select file > under external file access choose public
Once you have configured the smart fields you want to use, go to marq, open one of your templates, and add the smart fields to your template by dragging them in from the smart fields tab.
Once you have saved the template, the template will be ready for data to be applied automatically without any additional work. All you will need to do is create a project, and the data will automatically populate in real-time. If there are any smart fields that do not have data, they will populate as blank. 
If using multiple files in one field, you can click on an image > replace image and select from any of the available images. 

Uninstall the app


To disconnect Marq from your HubSpot account, follow these steps:

  1. Go to app marketplace > HubSpot
  2. Select Disconnect HubSpot
  3. To uninstall the Marq app card in HubSpot, navigate to your connected apps in the App Marketplace in HubSpot and select Manage apps. Search for Marq and then select Actions > Uninstall.