Skip to content
Docs

Credit Packages & Costs

This page covers the two halves of credit pricing: what employers pay you for credits (packages) and what posting a job costs them in credits.

Changed in 1.4.2: earlier builds shipped a standalone “Credit Packages” admin screen (a custom post type with its own editor and a /credits/packages REST endpoint). That screen was never wired into the purchase flow, so it was removed. Credits are now sold through your active purchase channel - a WooCommerce product, a membership level, or a direct Stripe/PayPal checkout - and “package” simply means the product or level you map to a credit amount. There is no longer a “Credit Packages” menu in wp-admin.

How credit packages work now

Section titled “How credit packages work now”

A credit package is whatever you sell that grants credits:

You connect each product or level to a credit amount in WP Career Board -> Settings -> Credits -> Credit Mappings. That mapping is what turns a completed purchase into a topup on the employer’s ledger.

Example pricing structure

Section titled “Example pricing structure”

A typical tiered set of WooCommerce products:

Product Credits Price Per-Credit Cost
Starter 3 credits $29 $9.67
Growth 10 credits $79 $7.90
Agency 25 credits $149 $5.96

Bulk packages offer better value, which encourages larger purchases. Create one product per tier, then add one Credit Mapping per product.

Setting the job-post cost

Section titled “Setting the job-post cost”

Credits are opt-in (since 1.3.0). Posting a job is free by default; a board only charges credits once you give it a per-board cost.

  1. Go to WP Career Board -> Job Boards and edit a board.
  2. Set its Credit cost (the number of credits a job post deducts on that board).
  3. Save.

The cost is per board, so different boards can charge different amounts. The posting gate and the credit hold both read this same value, so what an employer is quoted is exactly what is held.

A premium board (credit cost greater than 0) automatically marks its jobs as Featured.

Republishing an expired job

Section titled “Republishing an expired job”

Republishing an expired job back onto a paid board charges credits again, just like the first post: the board’s credit cost is held and then deducted from the employer’s balance, and the move is recorded in the ledger. Republishing to a free board (cost 0) charges nothing. Developers can change the republish cost - for example to run a “renew cheaper than re-post” price - through the wcb_job_republish_credit_cost filter, which defaults to the board’s normal cost.

Tiered pricing by membership

Section titled “Tiered pricing by membership”

The base per-board cost can be discounted (or waived) per BuddyPress member type, PMPro level, or MemberPress membership using the tiered credit pricing matrix. The cheapest applicable tier wins, so a paid membership can post for less - or for free.

Free job posting

Section titled “Free job posting”

To keep posting free, leave the board credit cost at 0 (the default). The credit system stays installed, so you can switch a board to paid later just by setting a cost - no migration needed.

Employer credit balance

Section titled “Employer credit balance”

Employers see their current credit balance in:

  • The Employer Dashboard header.
  • The Credit Balance block / [wcbp_credit_balance] shortcode on any page.

When the balance is too low to post to a paid board, the posting request is rejected before the job is inserted, and the dashboard shows a Buy Credits button (when a purchase URL and a mapping are both set - see Overview).

Granting credits manually

Section titled “Granting credits manually”

Admins can add (or remove) credits for any employer from WP Career Board -> Settings -> Credits -> Admin Credit Adjustment - see Manual adjustments & refunds.

Viewing the credit ledger

Section titled “Viewing the credit ledger”

Every top-up, hold, deduction, and refund is recorded in an append-only ledger. An employer’s recent history shows in the Credit Balance block (Transaction History panel) and is available over the REST API at GET /wcb/v1/employers/{id}/credits.