--- title: "Matching Gifts" slug: "matching-gifts-1" status: "new" updated: 2026-08-24T18:09:35Z published: 2026-08-24T18:09:35Z canonical: "knowledge.technolutions.net/matching-gifts-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.technolutions.net/llms.txt > Use this file to discover all available pages before exploring further. # Matching Gifts Slate supports a complete matching gift workflow — from automatically identifying potential matching gifts when a donor's gift is received, to fulfilling those matches when the company sends payment. This process is built on a shared, crowdsourced repository of company matching gift policies that benefits all Slate for Advancement institutions. This article explains how the matching gift process works from end to end: how policies are managed, how Slate identifies and creates potential matches, how statuses are tracked, and how a fulfilled matching gift is entered and linked back to the original donor gift. ## Key Concepts ### Central Matching Gift Repository Slate maintains a central repository of companies and their matching gift policies. This repository is shared across all Slate for Advancement institutions. When one institution adds a company, adds a policy, or updates a policy, that information becomes available to every other institution using the repository. Over time, as more institutions contribute, the repository becomes richer and more current. ### Company & Foundation Records Each institution maintains its own local company and organization records. These are stored as dataset records of the "Companies and Foundations" dataset. A company record can exist independently, but its matching gift policies are only visible and usable once it is linked to the central repository. These dataset records will be referenced throughout this article as local company records. ### Repository Companies A repository company is a company record in the central Slate repository. It has a name, an optional address, and can have one or more matching gift policies. The repository company record can be linked to a local company record, making the shared policies available for that local company. ### Matching Gift Policies A matching gift policy describes the rules a company uses to match employee donations. Policies are attached to repository company records and are visible to all institutions that have linked a local company to that repository record. A policy may include: | **Field** | **Description** | | --- | --- | | Name | A label for the policy, such as “Standard Match” | | Status | Whether the policy is active or inactive | | Effective Date | The first date the policy applies | | Expiration Date | The last date the policy applies | | Match Ratio | The multiplier applied to the donor’s gift, such as `1.00` for a 1:1 match | | Minimum Donation | The minimum donor gift amount required for a match | | Maximum Match Amount | The maximum amount the company will match for a single gift | | Annual Maximum Match Amount | The maximum amount the company will match for a donor during the policy fiscal year | | Fiscal Year Start | The month and day used to determine the company’s policy fiscal year | | Payout Schedule | How frequently the company typically pays matches | | URL | A link to the company’s matching gift program page | | Notes | Additional information about the policy | Inactive policies remain visible but are not evaluated for automatic matching. ### **Originating Gift** The originating gift is the donor’s original received hard-credit gift. This is the gift that Slate evaluates to determine whether a potential matching gift should be created. ### Potential Matching Gifts A potential matching gift is a gift created on the donor's record to represent a match that may be forthcoming from the company. It has **Status Category** of “Matching” and its parent field points to the originating received gift. Potential matches are created automatically when a received gift meets a company's policy criteria, or they can be entered manually. ### Fulfilled Matching Gifts A fulfilled matching gift is the actual received gift from the company, entered on the company's record. It is linked back to the potential match (and through that, to the original donor gift) through Slate's fulfillment workflow. It is the hard credit gift on the company’s record. ### Matching Gift Lifecycle Flow At a high level, the matching gift workflow follows this sequence: 1. An institution links a local company record to a company in the central matching gift repository. 2. One or more matching gift policies exist for that repository company. 3. A donor with an employment record for that company makes a received hard-credit gift. 4. Slate evaluates the gift against active matching gift policies for the donor’s employer. 5. Slate creates a potential matching gift on the donor’s record if the gift qualifies. 6. Staff review and update the potential matching gift as needed. 7. The company sends payment. 8. Staff enter the hard credit gift on the company record. 9. The company gift fulfills the potential matching gift. 10. Slate links the fulfilled company gift to the potential match, and the potential match remains linked to the original donor gift. ## **Permissions and Shared Repository Stewardship** Because matching gift policies are stored in a central repository, policy changes affect all institutions using that repository company. Users need the **Giving Update** permission to add or modify matching gift policies. When editing policies, keep the following in mind: - Policy additions affect all institutions linked to the repository company. - Policy updates affect all institutions linked to the repository company. - Inactive policies are not used for automatic matching. - Institutions should generally inactivate outdated policies instead of deleting them. - Policy information should be verified before saving. - Notes should be useful to other institutions, not just your own. > [!CAUTION] > 🔔 Important! > > Matching gift policies are not institution-private. A policy added to the repository is shared. If a policy is specific only to your institution, do not add it as though it were a general company policy. ## How the Central Matching Gift Repository Works When an institution links one of its local company records to the central repository, Slate displays matching gift policies from the central repository on that company's record. From the company's "Matching Gift Policies" tab, users can see all policies — including those added by other institutions — and can add, edit, or deactivate policies. > [!CAUTION] > 🔔 Important! > > All policy changes, additions, and deletions affect the global repository. A policy you add, edit, or deactivate will be changed for every institution using that same repository company. This is by design — the goal is a crowdsourced, continuously improving database of accurate matching gift policies. Institutions are expected to be good stewards of shared policy data. ### Linking or Adding a Local Company to a Repository Company Before Slate can evaluate matching gift eligibility or display policies, a local company record must be linked to the central repository. To link a local company: 1. Open the local company record. 2. Navigate to the **Giving** tab and select **Matching Gift Policies**. 3. If the record is not yet linked, a message will display: "This record has not yet been linked to a shared company record. Please link to see matching gift policies." 4. Click **Link Record**. 5. In the dialog, type the company name to search the central repository. A live lookup searches against the shared repository. 6. Select the matching repository company from the results and click **Save**. The local company will now be linked to the repository company, and all policies that company will appear on the local record's Matching Gift Policies tab. #### What if the company is not in the central repository? If no match is found during the search, a "No matches found. **Add new Company**" link appears. Clicking it opens a dialog that is pre-filled with the local company's name and address. Confirming saves the company to the central repository and automatically links it to the local record. To unlink a local company from the repository: 1. Navigate to the **Giving Tab** and select **Matching Gift Policies** 2. Click the **Edit** link that displays on top of the table containing the policies 3. In the dialog, click **Delete** A confirmation prompt warns that existing gifts will not be affected. After unlinking, the local record will no longer display repository policies, and no new potential matches will be generated based on central policies. ### Adding or Updating Matching Gift Policies Policies are managed from the **Matching Gift Policies** tab on a linked local company record. #### Add a new policy 1. Click **New Matching Gift Policy**. 2. Enter the details for the policy. Required fields are: 1. Name 2. Match Ratio 3. Minimum Donation 4. Maximum Match Amount 5. Fiscal Year Start Day 3. Click **Save**. #### Edit an existing policy 1. Click on the policy from the policies list. 2. Make your changes in the dialog. 3. Click **Save**. #### Deactivate a policy without deleting it 1. Open the policy from the policies list. 2. Set the **Status** field to **Inactive**. 3. Click **Save**. Inactive policies are not evaluated during matching but remain visible. ### Global Policy Updates When you save a policy change, Slate writes that change to the central repository and triggers a synchronization to all connected institutions. This means: - A policy correction you make will take effect for your institution and all others. - A new policy you add becomes visible to all institutions using that repository company. - Deactivating a policy removes it from matching evaluation everywhere. - Adding a company to the repository makes it available for other institutions to link to their local companies This crowdsourced model ensures that policy data improves over time, but it also means that incorrect data can spread. Always verify that changes are accurate before saving. ## Identifying Matching Gifts When a donor makes a gift, Slate check whether the gift should be queued for matching. The following conditions must all be true for a gift to be evaluated: - The gift's status category corresponds to the **Received** category (potential matches are not created for pledges and planned gifts). - The gift is a **hard credit** gift. - The Automatic Matching Gifts configuration key is set to **Enabled**. When these conditions are met, the gift is queued in Slate's deferred trigger system. The matching process runs as part of Slate's regular background service, which executes about every 15 minutes. What the process does: 1. Retrieves all recently-received gifts that are pending matching evaluation. 2. For each gift, looks up the donor's job/employment records to identify any employer companies. 3. Checks whether the employer company's is linked to a repository company. 4. Retrieves active matching gift policies from the central repository for any linked companies. 5. Evaluates each policy's criteria against the gift. 6. Calculates the potential match amount for each qualifying policy. 7. Selects the highest-value policy. 8. Creates a potential matching gift record on the donor's record. ### Matching Policy Criteria and Eligibility Slate evaluates the following for each policy: | Criteria | How It’s Evaluated | | --- | --- | | Active | Policy must be marked as Active | | Effective / Expiration Dates | Gift date must fall within the policy's effective–expiration date range (either or both endpoints may be blank, which means "no limit") | | Minimum Donation | Gift amount must be ≥ the policy's minimum | | Employment | The donor must have a job record linking them to the employer, and that employer must be a dataset record linked (via sid) to the repository company that owns the policy | | Employment Dates | The job's start and end dates must include the gift date (blank start/end means no constraint) | ### Calculating the Potential Match Amount For each qualifying policy, Slate calculates the potential match amount as follows: **Step 1: Per-gift match amount** This amount is calculated by multiplying the gift amount by the ratio, limited by the maximum match amount. For example, if the gift is $500 and the ratio is 1.00 (1:1) with a $1,000 maximum match amount, the initial match amount is $500. If the gift is $1,200 and the ratio is 1.00 with a $1,000 maximum match amount, the initial match amount is $1,000. **Step 2: Annual maximum check** Slate calculates the policy's fiscal year boundaries based on fiscal year start date of the policy relative to the gift date. We then sums all prior fulfilled matching gifts in that fiscal year for the same donor and policy, and reduce the available match accordingly. If the available match is less than the calculated per-gift amount, the match amount is reduced to what is still available. If the available match is zero or negative, the match amount is zero, and no potential match is created for that policy. Annual maximum is optional: If a policy has no annual maximum, Slate uses only the per-gift maximum. ## Multiple Policies and Multiple Employers A donor may have multiple qualifying matching gift options. Slate handles this differently depending on whether the donor has multiple policies for the same employer or multiple eligible employers. ### Multiple Policies for the Same Employer A company may have more than one active matching gift policy. When more than one policy qualifies for the same employer, Slate creates only one potential matching gift for that employer. Slate selects the highest-value qualifying policy using this order: 1. Highest match amount 2. Highest annual maximum 3. Earliest fiscal year start date 4. Policy ID (final tiebreaker so results are consistent) Only one potential matching gift record is created per originating gift, per employer. ### Multiple Employers for the Same Donor If a donor has multiple employers and more than one employer has an eligible matching gift policy, Slate can create one potential matching gift per eligible employer. For each employer, Slate evaluates that employer’s active policies and selects the highest-value qualifying policy for that employer. For example, if a donor has eligible employment records with two companies, and both companies have qualifying policies, Slate may create two potential matching gifts for the same originating donor gift: one for each employer. ## How Potential Matching Gifts are Created Potential matching gifts are created in two ways: **Automatically (on a deferred basis):** When the Automatic Matching Gifts configuration key is enabled, Slate evaluates for potential matches on a recurring basis. This process evaluates all gifts that have been queued since the last run and creates potential matches where criteria are met. The automatic process also handles reversals: if an originating gift is reversed, any associated potential matching gift is automatically deleted. **Manually** Users with Giving Update permission can create a potential matching gift manually from the Potential Matching Gifts tab on a donor record. Upon clicking the **New Potential Matching Gift** link, you will be prompted to select: - **Originating Gift** — the gift this potential match is linked to - **Policy** — an eligible policy (only policies with active employers in the donor's job records are displayed) ### What Fields are Copied to the Potential Matching Gift When Slate creates a potential matching gift, it copies the following fields from the originating gift: - Fund - Notes - Occasion - Honoring/tribute information - Campaign - Project - Appeal - Source - Anonymous flag - Source gift The potential match uses: - The donor's record (not the company's) as the gift record - The match amount (calculated from the policy) - The originating gift's ID as its parent field - The policy ID that triggered the match - A gift type drawn from the lowest-order prompt with Matching status category - A gift status drawn from the lowest-order prompt in the Matching status category The potential match does not include: - Payment information - Soft credits from the originating gift Soft credits from the originating gift are applied later during fulfillment, when the company’s received gift is entered. ### What Does Not Recalculate Automatically Potential matching gifts are created based on the gift, employer, and policy information available at the time Slate evaluates the originating gift. After a potential matching gift is created, Slate does not automatically recalculate or update it when related information changes. | **Change** | **Effect on Existing Potential Matches** | | --- | --- | | Originating gift amount changes | Existing potential match amount does not recalculate. | | Originating gift date changes | Existing potential match eligibility does not recalculate. | | Fund, campaign, project, appeal, or other copied fields change on the originating gift | Existing copied values on the potential match are not automatically updated. | | Matching gift policy is edited | Existing potential matches created from the prior policy values are not updated. | | Matching gift policy is inactivated | Existing potential matches remain in place. | | Donor employment information changes | Existing potential matches are not automatically revised. | | Local company is linked to or unlinked from the repository | Existing potential matches are not automatically revised. | If a potential matching gift needs to reflect updated information, users should edit the potential matching gift manually, create a new manual potential match where appropriate, or update its status to reflect the institution’s workflow. ### Where Potential Matching Gifts Appear On a **donor's record**: The Potential Matching Gifts tab appears in the Giving section of a person record. This tab shows all gifts with a category of Matching. On a **company record**: Company records show a Potential Matching Gifts tab that displays all potential matches whose associated policy belongs to that company. This allows users to see all outstanding potential matches for a given employer in one view. On a **gift record**: Opening a potential matching gift displays its details, including the originating gift it is linked to, the associated policy, the match amount, and its current status. In **queries and reports**: The gift query base includes potential matching gifts. These potential matching gifts will be in the Status Category of Matching. ## Gift Status and Gift Type for Potential Matching Gifts ### Gift Status The status is set to the lowest-order prompt with the gift_status key that has the category of Matching. At setup, Slate inserts four default status prompts in the Matching category: | Status | Default Order | Typical Meaning | | --- | --- | --- | | Potential | 5 | Slate identified as a possible matching gift | | Expected | 10 | Staff believe the donor or company is likely to complete the match. | | Matched | 15 | Staff have confirmed or processed the match. | | Not Expected | 20 | Staff do not expect the match to be fulfilled. | Because "Potential" has the lowest order (5), new potential matches are automatically assigned this status. Administrators can add, reorder, or rename these statuses in the Prompts tool. Changing the order affects which status is automatically assigned to newly created potential matches. #### Changing the Status Manually On a donor record, open a potential matching gift and click **Edit**. You can change the status to any active prompt in the Matching category (e.g., from "Potential" to "Expected" or "Not Expected"). Save the gift. Changing the status — either manually via an administrator or via a mapping destination on a form — will allow institutions to track anticipated potential matches as they learn if the donor intends to complete the claim process with their employer. ### Gift Type When a potential matching gift is created, it is assigned the gift type that is the lowest-order prompt with the gift_type key that has the category of Matching in its XML configuration. At setup, Slate automatically inserts a "Matching" type prompt if one does not already exist. To add this Matching PKV to existing prompts, add the following to the XML configuration of the prompt: ```xml