> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Cards in the Marqeta Dashboard

> Use Card Management in the Marqeta Dashboard to manage your card products.

<Warning>
  Marqeta is migrating dispute management to the new Disputes portal. To learn about the Disputes portal, see [About the Disputes Portal](/developer-guides/about-disputes-portal).
</Warning>

Use Card Management in the [Marqeta Dashboard](https://app.marqeta.com/) to manage your cards and card programs. Card Management includes tools for exploring your card products and creating either single cards or cards in bulk from your card products.

Using Card Management, you can view all of the card products configured for your program, and:

* View all configured card products (virtual and physical) and relevant information.

* Order cards from existing card products (either single or in bulk).

* View the results of bulk card ordering file uploads.

<h2 id="_the_basics">
  The basics
</h2>

To manage card products, log into the [Marqeta Dashboard](https://app.marqeta.com/), select **Dashboard** in the upper-left corner, then select **Card Management > Card products** in the sidebar. For more on accessing the Marqeta Dashboard, see [Accessing the Marqeta Dashboard](/developer-guides/dashboard-overview-and-quick-start/#_access_the_marqeta_dashboard).

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/TxQgVKoSBbsxuEcD/images/docs/developer-guides/cards-dashboard/dashboard_manage_your_card_program.png?fit=max&auto=format&n=TxQgVKoSBbsxuEcD&q=85&s=79038ccfcb21cbccf196abf76381dc5c" alt="Card management" width="2638" height="1390" data-path="images/docs/developer-guides/cards-dashboard/dashboard_manage_your_card_program.png" />
</Frame>

<h2 id="_how_to">
  How to…
</h2>

* <a href="#_viewing_a_list_of_card_products" class=" vbdy">View a list of card products</a>
* <a href="#_viewing_card_product_details" class=" vbdy">View card product details</a>
* <a href="#_manually_creating_a_card" class=" vbdy">Manually create a card</a>
* <a href="#_creating_cards_in_bulk" class=" vbdy">Create cards in bulk</a>

<h2 id="_viewing_a_list_of_card_products">
  Viewing a list of card products
</h2>

To view a list of card products, go to **Dashboard > Card management > Card products**. The current card products are displayed with summary information, including the network, classification type, and BIN prefix.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/TxQgVKoSBbsxuEcD/images/docs/developer-guides/cards-dashboard/dashboard_manage_your_card_program.png?fit=max&auto=format&n=TxQgVKoSBbsxuEcD&q=85&s=79038ccfcb21cbccf196abf76381dc5c" alt="Card management" width="2638" height="1390" data-path="images/docs/developer-guides/cards-dashboard/dashboard_manage_your_card_program.png" />
</Frame>

<h2 id="_viewing_card_product_details">
  Viewing card product details
</h2>

To view a list of card products:

<Steps>
  <Step>
    Select **Dashboard** in the upper-left corner, then select **Card Management > Card products** in the sidebar.
  </Step>

  <Step>
    Select the card product to view. Detailed information includes card product information and information on product velocity and authorization controls.

    <Frame>
      <img src="https://mintcdn.com/marqeta-b295cded/TxQgVKoSBbsxuEcD/images/docs/developer-guides/cards-dashboard/dashboard_card_management_individual_card_product_page.png?fit=max&auto=format&n=TxQgVKoSBbsxuEcD&q=85&s=4b48bc276bd435e9461177100501ab34" alt="Card product" width="2636" height="1412" data-path="images/docs/developer-guides/cards-dashboard/dashboard_card_management_individual_card_product_page.png" />
    </Frame>
  </Step>
</Steps>

<h3 id="_card_product_information">
  Card product information
</h3>

| Field                | Description                                                         |
| -------------------- | ------------------------------------------------------------------- |
| Start Date           | The start date of the card product.                                 |
| Network              | The network associated with the card product.                       |
| Classification       | The classification of the card product: consumer or commercial.     |
| BIN Prefix           | The prefix of the bank identification number (BIN).                 |
| Token                | The card product identifier.                                        |
| Type                 | The type of card product: debit, credit, or prepaid.                |
| Fulfillment Provider | The fulfillment provider: `PERFECTPLASTIC`, `ARROWEYE`, or `IDEMIA` |
| Funding              | The type of funding, such as prefunded.                             |
| Package ID           | The identifier for the package.                                     |
| Program ID           | The identifier for the program.                                     |

<h3 id="_card_product_velocity_and_authorization_controls">
  Card product velocity and authorization controls
</h3>

| Field            | Description                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------------- |
| Usage type       | How the card is used: Multi-use or single-use.                                                 |
| MCC auth control | Controls the expiration of authorizations and automatic increases to the authorization amount. |
| Deny list MCC    | Merchant category codes for merchant types added to the deny list.                             |
| Velocity control | Velocity controls applied to the card.                                                         |

<h2 id="_creating_a_card">
  Creating a card
</h2>

You can manually create a card or create cards in bulk by uploading a file that contains the information about the cards to create. When you create a card, a card is created from a card product. When you manually create a card, you will create a single card and will need to enter the details. For bulk card creation, the details are entered into a file that can be uploaded to create multiple cards from the card program.

<h3 id="_manually_creating_a_card">
  Manually creating a card
</h3>

When you manually create a card, a new card is issued from the currently selected card product. To manually create a card:

<Steps>
  <Step>
    Select **Dashboard** in the upper-left corner, select **Card management > Card products**, and then select a card product.
  </Step>

  <Step>
    In the upper-right corner, select **Create card > Manual create card**.

    <Frame>
      <img src="https://mintcdn.com/marqeta-b295cded/TxQgVKoSBbsxuEcD/images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_manual_create_card.png?fit=max&auto=format&n=TxQgVKoSBbsxuEcD&q=85&s=77134410294778d25e2ff2f101cf5f65" alt="Create card" width="2628" height="1414" data-path="images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_manual_create_card.png" />
    </Frame>
  </Step>

  <Step>
    In **Manual create card**, enter the details for the card.

    | Name line 1          | Name for card personalization.                                                                                                                                                                                                                                            |
    | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Name line 2          | Additional name information, if necessary.                                                                                                                                                                                                                                |
    | Cardholder signature | A PNG image of the cardholder’s signature.                                                                                                                                                                                                                                |
    | Expedite             | Indicated whether to expedite the manufacturing time at the provider’s site. Shipping will not be expedited.                                                                                                                                                              |
    | Shipping method      | The card shipping method: LOCAL MAIL, TWO DAY, OVERNIGHT, or INTERNATIONAL                                                                                                                                                                                                |
    | Card carrier         | Select **+ Add card carrier** to open the popup window. Enter the logo file name, a message line, and for Carrier return window, specify a PNG image to display in the return address window of envelopes used to send cards to cardholders. Select **Add card carrier**. |
    | Return address       | Select **+ Add address** to open the popup window. Enter the address information, and select **Add address**.                                                                                                                                                             |
    | Shipping address     | Name and address where card is to be shipped.                                                                                                                                                                                                                             |
    | Card user name       | First and last name of the card user.                                                                                                                                                                                                                                     |
    | Deny list MCCs       | Merchant category codes (MCCs) to deny. To add additional MCCs, select **+ More MCCs**.                                                                                                                                                                                   |
    | Usage type           | How the card is to be used: Multi-use or single-use.                                                                                                                                                                                                                      |
    | Velocity control     | Any amount and usage controls for a given time interval within the preconfigured controls. To add an additional control, select **+ Add velocity control** and enter the control details.                                                                                 |
  </Step>

  <Step>
    Select **Create card**.
  </Step>
</Steps>

<h3 id="_creating_cards_in_bulk">
  Creating cards in bulk
</h3>

To create cards in bulk:

* Download the template.

* Create the bulk upload file.

* Create the object rows.

* Upload the file.

* View the response report.

Each of these steps is described in detail in the following sections.

<h4 id="_download_the_template">
  Download the template
</h4>

To download the template:

<Steps>
  <Step>
    Select **Dashboard** in the upper-left corner, select **Card management > Card products**, and then select a card product.
  </Step>

  <Step>
    In the upper-right corner, select **Create card > Bulk create cards**.

    <Frame>
      <img src="https://mintcdn.com/marqeta-b295cded/TxQgVKoSBbsxuEcD/images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_download_template.png?fit=max&auto=format&n=TxQgVKoSBbsxuEcD&q=85&s=2cc402a52ba644defbadcefe16d51865" alt="Download template" width="2640" height="1410" data-path="images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_download_template.png" />
    </Frame>
  </Step>

  <Step>
    In **Bulk create cards**, select **Download CSV template** in the upper-right corner.
  </Step>
</Steps>

<h4 id="_create_the_bulk_upload_file">
  Create the bulk upload file
</h4>

Using the template, create and populate your upload file. The file must conform to the following requirements:

| Requirement          | Description                                                                                                                                                                                                                                              |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| File format and size | The bulk upload file must be in .csv format and not exceed 10 MB in size.                                                                                                                                                                                |
| Header row           | The first row of the CSV file must begin with `HEADERS`, followed by a comma-separated list of the field names you want to include for each record in the file. For example:<br /><br />`"HEADERS, ApplyToUser, UserToken, UserFirstName, UserLastName"` |
| Comments row         | The `COMMENTS` row of the CSV file is ignored—these descriptions are provided to help you populate the template.                                                                                                                                         |
| Object rows          | Each row after the `COMMENTS` row represents a new or updated object on the Marqeta platform.                                                                                                                                                            |

<h4 id="_create_the_object_rows">
  Create the object rows
</h4>

To create a new object, begin a new row in the CSV file after the Comments row with the keyword `CREATE`. To update an existing object, begin the row in the CSV file with the keyword `UPDATE`.

The `CREATE` action represents a `POST` request to the Core API of the Marqeta platform, while the `UPDATE` action represents a `PUT` request.

Follow either action with a comma-separated list of values that matches the fields you included in the `HEADERS` row, such as `CREATE, true, myUserToken, John, Smith`.

For each object row of the CSV file, you must specify whether you are creating or updating a user, card, or funding request.

* For rows that create or update a user, set `ApplyToUser` to `true`.

* For rows that create or update a card, set `ApplyToCard` to `true`.

* For rows that create a funding request, set `ApplyToFunds` to `true`.

<Danger>
  **Warning**\
  You can create a new funding request, but you cannot update an existing request.
</Danger>

When creating an object, you must include one of the following field names in the `HEADERS` row with the appropriate value for each record:

* To create a User object – no required field.

* To create a Card object – `CardProductToken`.

* To create a Funding Request object – `FundsAmount`.

<h4 id="_upload_the_file">
  Upload the file
</h4>

To upload the bulk file:

<Steps>
  <Step>
    Select **Dashboard** in the upper-left corner, select **Card management > Card products**, and then select a card product.
  </Step>

  <Step>
    In the upper-right corner, select **Create card > Bulk create cards**.
  </Step>

  <Step>
    In **Bulk create cards**, select **Browse** and locate the CSV file.

    <Frame>
      <img src="https://mintcdn.com/marqeta-b295cded/TxQgVKoSBbsxuEcD/images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_create_bulk_cards.png?fit=max&auto=format&n=TxQgVKoSBbsxuEcD&q=85&s=5c6cf20733568d7c51f46474430b6ab0" alt="Create card" width="2632" height="1412" data-path="images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_create_bulk_cards.png" />
    </Frame>
  </Step>

  <Step>
    Select **Create cards**.
  </Step>
</Steps>

<h4 id="_view_the_response_report">
  View the response report
</h4>

After the Marqeta platform processes your bulk upload file, it generates a response report containing your complete request along with response data for each record in the file. Depending on the size of the upload file, the report may take several minutes to generate.

To view the report:

In **Card products**, select **Bulk card response** in the upper-right corner.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/TxQgVKoSBbsxuEcD/images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_bulk_card_response.png?fit=max&auto=format&n=TxQgVKoSBbsxuEcD&q=85&s=69f01657573c2c2cd24afb61eaacb36a" alt="Bulk create card response" width="2632" height="1410" data-path="images/docs/developer-guides/cards-dashboard/dashboard_creating_cards_bulk_card_response.png" />
</Frame>

If you do not see the report for the upload file, check back after 20 to 30 minutes.

<h3 id="_recovering_from_an_error">
  Recovering from an error
</h3>

If any of the object rows in your bulk upload file generate an error during processing, the Marqeta platform includes the error in the response report. For each object, a description of the error is returned in one of the following fields:

* `UserMessage`, if `ApplyToUser` is `true` in the request.

* `CardMessage`, if `ApplyToCard` is `true` in the request.

* `FundsMessage`, if `ApplyToFunds` is `true` in the request.

To correct your bulk upload file, update each object row of the response report file based on the errors returned by the Marqeta platform. When ready, upload the response report file.

<Danger>
  **Warning**\
  Do not modify the filename or other elements of the response report file.

  Do not re-upload the original bulk upload file.
</Danger>


## Related topics

- [Managing Customers in the Marqeta Dashboard](/docs/developer-guides/customers-dashboard.md)
- [Managing User Profiles in the Marqeta Dashboard](/docs/developer-guides/user-profiles-dashboard.md)
- [Dashboard Overview and Quick Start](/docs/developer-guides/dashboard-overview-and-quick-start.md)
- [Disputes in the Marqeta Dashboard](/docs/developer-guides/disputes-dashboard.md)
- [Managing Mastercard Disputes](/docs/developer-guides/managing-mastercard-disputes.md)
