A Blueprint is a CSV-based table that stores business logic as rows and columns. Blueprints are the logic layer of the Data Logic module — they define what should happen, and Data Logic applies it to your CRM records. Covers what a Blueprint is, how it works, how it differs from workflows, versioning, and how to create and manage Blueprints.
Blueprints are CSV-based tables that define business logic as rows and columns. Blueprints are the logic layer of the Data Logic module — they define what should happen, and Data Logic applies that logic to your CRM records.
Blueprints are created and managed under Operations > Blueprints and are available for use across all Data Logic configurations.
What a Blueprint Is
A Blueprint is a CSV file made up of input columns and output columns.
- Input columns define the matching conditions — the values the system checks against your CRM records to find a match.
- Output columns define the outcomes — the values written to your CRM fields when a record matches a row.
When Data Logic evaluates a record, it checks the record against each row in the Blueprint from top to bottom. The first row where all input column conditions are satisfied is the matching row. The output values from that row are then applied to the record's CRM fields according to the update conditions configured in Data Logic.
A Blueprint that assigns territory and sales tier based on country and employee count might look like this:
| Country | Employees | Territory | Sales Tier |
|---|---|---|---|
| United States | 500–1000 | North America Enterprise | Enterprise |
| United States | 100–499 | North America Mid-Market | Mid-Market |
| Germany | 100–500 | DACH Mid-Market | Mid-Market |
In this Blueprint, Country and Employees are the input columns used to match records, and Territory and Sales Tier are the output columns whose values are written to CRM fields when a match is found. A company record with Country = United States and Employees = 750 matches the first row and receives the corresponding Territory and Sales Tier values.
Why Blueprints Exist
CRM business logic — territory assignments, lead scoring, field classifications, routing rules, etc. — is traditionally spread across HubSpot Workflows, Salesforce Flows, automation rules, and scripts. Each piece of logic lives in a different place, requires different expertise to maintain, and can break when conditions change. Updating a territory model means editing Workflow branches. Changing a scoring model means modifying scripts. Nothing is visible in one place, and nothing is easy to hand off.
Blueprints solve this by separating logic definition from logic execution. The Blueprint is the single source of record for a piece of business logic. When the logic changes — a new territory, a revised scoring model, updated suppression rules, new SKU classifications — you update the Blueprint table and upload a new version. The Data Logic configuration that applies it to your CRM stays the same. No Workflow rebuilds, no code changes, no redeployment.
How Blueprints Differ from Workflows
HubSpot Workflows and Salesforce Flows use branching if/else logic. As the number of conditions grows, they become difficult to read, slow to update, and brittle to maintain. A territory model covering 50 countries with size-based tiers requires hundreds of branches. The same logic in a Blueprint is a table with rows that any RevOps or operations team member can read, edit, and version — without touching a single Workflow or Flow.
Blueprints also support multi-field matching and multi-field outputs in a single operation. One matching row can evaluate conditions across Country, Industry, and Employee Count, and write back Territory, Sales Tier, Owner, and Region in a single step. Workflows and Flows typically require separate branches and actions for each output field.
Blueprints are not a full replacement for all Workflows or Flows. They are purpose-built for table-driven, multi-field conditional logic — territory assignment, ICP scoring, renewal risk scoring, compliance enforcement, pricing governance, lead source harmonization, and similar use cases. For processes that go beyond field updates — such as sending emails, creating tasks, triggering notifications — Workflows and Flows remain the right tools. Blueprints handle the data logic, while Workflows or Flows handle the rest.
How Blueprints and Data Logic Work Together
A Blueprint on its own does nothing. It is a definition, not an executor.
Data Logic is the configuration layer that puts a Blueprint to work. It binds Blueprint columns to CRM fields, defines matching criteria for each input, sets update conditions for each output field, applies fallback values for records that don't match, and controls when and how the logic runs.
This separation is what makes the maintenance advantage possible. When business logic changes, you update the Blueprint. The Data Logic configuration stays the same — the same input mapping, the same output mapping, the same filters. The same Blueprint can also be referenced by multiple Data Logic configurations simultaneously, and the same Data Logic configuration continues to work unchanged when a new Blueprint version is uploaded.
For complete details on configuring Data Logic, see Module Overview: Data Logic.
Blueprint Versioning
Blueprints are versioned. Each time you upload a new version, Insycle retains all previous versions. You can preview any version and maintain a full history of how the table has changed over time. To restore a prior version, download it from the Table Preview panel and upload it as a new version.
When you upload a new Blueprint version, all Data Logic configurations that reference that Blueprint automatically use the updated version on their next run. No reconfiguration is required.
Creating and Managing Blueprints
Creating a Blueprint
Blueprints can be created from the Data Logic module or the Operations > Blueprints page.
Within Data Logic under 1. Pick Blueprint choose from five sources:
- Generate with AI — Describe your logic needs, and AI generates a Blueprint based on your CRM field metadata and value distributions. There are three paths: Suggested for your data (AI identifies logic opportunities in your CRM), Common use cases (pre-built patterns for territory assignment, scoring, normalization, and similar use cases), and Build your own (define your own input and output fields). For a step-by-step walkthrough, see Generate a Blueprint with AI.
- Explore Examples — Browse a library of Insycle-provided example Blueprints for common use cases, including lead source harmonization, compliance and suppression list enforcement, renewal risk scoring, legacy CRM field migration, and more.
- Use Reference Data — Select from Insycle-maintained reference datasets, including GDPR adequacy data, NAICS 2022 industry codes, and SIC codes.
- Create from CSV — Upload a CSV file to create a new Blueprint directly from within Data Logic.
- Select Existing — Choose from Blueprints you have already created and saved under Operations > Blueprints.
The image above shows the 1. Pick Blueprint step in the Data Logic module, configured for a HubSpot demo account with the Contacts object type selected. The five Blueprint source options are listed — Generate with AI, Explore Examples, Use Reference Data, Create from CSV, and Select Existing — with Use Reference Data selected (indicated by the filled radio button). The Blueprint dropdown to the right of Use Reference Data shows GDPR Adequacy Reference selected, with description and version info, preview, and refresh icons displayed alongside it.
Blueprints can also be created by uploading a CSV directly from the Operations > Blueprints page, without going through the Data Logic module.
The image above shows the Operations > Blueprints page for a HubSpot demo account. The page displays a list of saved Blueprints with Name, Description, and File Name columns. Two Blueprints are partially visible: Derive Country from State/Province Code, which maps state and province values to their parent country, and Industry + Country → Success Tier & Territory, which matches accounts on Industry and Country/Region to assign Success Tier and Territory values. An Upload button and a Generate button are available at the top of the page, along with a filter field for searching the list.
Managing Blueprints
Blueprints are created and managed under Operations > Blueprints.
To create a new Blueprint:
- Navigate to Operations > Blueprints.
- Click New.
The image above shows the Operations > Blueprints page with the left navigation expanded, showing Blueprints selected under the Operations section. The New button is visible at the top of the Blueprint list, with an arrow pointing to it. The list shows four saved Blueprints: Automobiles, Map Country, Territory ID, and Owner (described as "Map Country and Territory ID"), Simple discount and assignment (described as "Global Sales"), and Company Enrichment.
- In the Create Blueprint popup, enter a name and, optionally, a description.
- Click Upload and select your CSV file.
- Click Create.
The image above shows the Create Blueprint popup with a name, optional description, and uploaded CSV file. The Name field contains "Territory Assignment by Country, State, & Industry," and the Description field contains "assign Region, Territory Owner, Sales Tier, Account Type." A CSV file named Territory-Assignment-Country-State-Industry-AccountType.csv has been uploaded, shown with its file size, row count, column count, and modification date. The Upload button (yellow) and Create button (dark) are visible at the bottom of the popup.
To upload a new version of an existing Blueprint:
- Click the Blueprint in the list.
- In the Table Preview below the list, click the Upload New Version icon in the header.
The image above shows the Table Preview panel in Operations > Blueprints, displaying version v1 of a Blueprint with columns for Country, State, Industry, Region, Territory Owner, and Sales Tier. The first visible row shows United States / California / Technology mapped to West / Sarah Chen / Enterprise. An arrow points to the Upload New Version icon in the Table Preview header, with a tooltip reading "Upload New Version." A version dropdown, description, and version info icon, edit icon, and download icon are also visible in the header.
- In the Upload New Version popup, click the yellow Upload button and select your CSV file.
- Click the grey Upload button.
To preview a Blueprint:
When selecting a Blueprint in Data Logic, a Preview icon appears beside the Blueprint field. Clicking it opens a Blueprint Preview popup that displays the table data and a search field. Use the preview to confirm you have selected the correct Blueprint and version before configuring your input and output mapping.
The image above shows the 1. Pick Blueprint step in the Data Logic module with Explore Examples selected and the Data Quality Enforcement Blueprint chosen from the Blueprint dropdown. An arrow points to the Preview Blueprint icon (eye icon), with a tooltip reading "Preview Blueprint." The description, version info, and refresh icons are also visible alongside the dropdown.
Frequently Asked Questions
What is a Blueprint in Insycle?
A Blueprint is a CSV-based table that defines business logic as rows and columns. Each row represents a condition and its associated outcomes. Input columns define the values used to match records; output columns define the values written to CRM fields when a match is found. Blueprints are used by the Data Logic module to apply that logic to your CRM records.
What is the difference between a Blueprint and Data Logic?
A Blueprint defines the logic — it is the table that stores your business rules as rows and columns. Data Logic is the module that applies that logic to your CRM records. Data Logic binds Blueprint columns to CRM fields, defines how records are matched, sets update conditions for each output, and controls when and how the operation runs. A Blueprint on its own does nothing; it requires a Data Logic configuration to be applied to your data.
What kinds of business logic can a Blueprint represent?
Blueprints are well-suited for any business logic that can be expressed as a table of conditions and outcomes. Common use cases include persona assignment, UTM normalization, lifecycle-stage enforcement, pricing-tier and discount governance, SKU standardization, and GDPR or consent management. Any logic that evaluates one or more CRM field values and writes one or more output values based on the results is a candidate for a Blueprint.
Does Blueprint row order matter?
Yes, row order matters in a Blueprint. When a record matches more than one row, Data Logic applies the first matching row — the row closest to the top of the Blueprint that satisfies all input conditions. More specific conditions should always appear above more general ones. For example, if you have one row matching Financial Services companies with over 100,000 employees and a separate row matching all Financial Services companies, the specific row must appear first. Row order is determined by the structure of the Blueprint CSV itself — it cannot be configured within Data Logic.
Can the same Blueprint be used in more than one Data Logic configuration?
Yes. Because a Blueprint exists independently of any Data Logic template, multiple templates can reference the same Blueprint simultaneously — each with different input mapping, output mapping, and filter configurations. This allows the same business logic to be applied to different object types, different CRM fields, or different subsets of records without duplicating the Blueprint. When you upload a new version of the Blueprint, all templates that reference it will use the updated version on their next run.
Can a Blueprint be used across different CRMs?
Yes. Because a Blueprint is simply a CSV table, independent of any specific CRM, the same Blueprint can be referenced by Data Logic configurations across different supported CRM connections — including HubSpot, Salesforce, and others. There is no need to create separate Blueprint files for each CRM.
What happens when I upload a new Blueprint version?
When you upload a new version of a Blueprint, Insycle retains all previous versions. All Data Logic configurations that reference the Blueprint automatically use the updated version on their next run — no reconfiguration is required. You can preview any version from the Table Preview panel in Operations > Blueprints.
Can I generate a Blueprint automatically instead of building one from a CSV?
Yes. The Generate with AI feature in the Data Logic module analyzes your CRM field metadata and generates a Blueprint based on your data, a common use case pattern, or your own custom instructions. There is no requirement to build a Blueprint from a CSV file. For a complete walkthrough, see Generate a Blueprint with AI.
Additional Resources
Related Help Articles
- Module Overview: Data Logic
- Generate a Blueprint with AI
- Integrate Insycle with HubSpot Workflows
- Integrate Insycle with Salesforce Flow
- Automation & Manual Operations
Related Blog Posts