Everything you need to know

1. Download wp-flashcard.zip from your account at wpflashcard.com (Purchase History).
2. In your WordPress admin, go to Plugins → Add New Plugin → Upload Plugin, choose the zip, and click Install Now, then Activate.
3. A new Flashcards menu appears in your admin sidebar.

If you were using WP Flashcard LITE, the full version automatically deactivates it and migrates your existing cards — nothing is lost.

Requirements: WordPress 5.8 or higher, PHP 7.4 or higher.

1. Find your license key in your purchase receipt email or your account page at wpflashcard.com.
2. Go to Flashcards → License, paste the key into the License Key field, and click Activate License.
3. You'll see a green active badge with your expiration date (or "Lifetime license").

An active license unlocks creating new sets, the Settings page, CSV import, and automatic updates. Your flashcards always keep displaying on the front end for visitors, license or not.

1. Go to Flashcards → Add New Set and give the set a title.
2. Click Publish once — the card editor activates after the first save.
3. Click Add Card, type the question in Front and the answer in Back, and click the row's Save button.
4. Repeat for as many cards as you like — there's no limit.

Tip: clicking the main Update button also saves any card edits still in progress, so you won't lose work.

Every set has a shortcode like [flashcard_set id="123"]. You can copy it from:

• The Shortcode box in the set editor's sidebar (with a one-click Copy button), or
• The Shortcode column on the Flashcards list screen.

Paste it into any post, page, or text widget. You can place multiple sets on the same page — each works independently. The plugin's styles and scripts only load on pages that actually contain flashcards.

• Flip — click or tap anywhere on the card (playing media or clicking the star won't flip it).
• Previous / Next — the arrow buttons under the card, with a "3 of 20" counter between them. On phones, swiping left/right also navigates.
• Star — the star button in the card's top-right corner marks a card for focused review later.
• Shuffle — toolbar button; randomizes the order without losing your place.
• Switch sides — toolbar button; shows backs first instead of fronts (great for reverse practice).

• → next card  ·  ← previous card
• Space, ↑, or ↓ — flip the card
• Enter — Start Over from the completion screen

With multiple sets on one page, shortcuts control the set the visitor used most recently.

After the last card, learners see a "Nice Work!" screen with how many terms they studied and options to:

• Start Over — run the deck again (shuffle is respected).
• Study Starred Terms — restart with only the cards they starred.
• Study all terms — return to the full deck from starred mode.

Starred cards, shuffle, and switched sides are remembered in the visitor's browser between visits. Position in the deck is not — a page reload starts from card 1.

1. Install and activate the add-on, then activate its license (Flashcards → WP Flashcard — AI Generator License).
2. Go to Flashcards → AI Generator → Settings tab.
3. Choose a Provider: OpenAI, Anthropic (Claude), or Custom/OpenAI-Compatible (works with OpenRouter, Groq, Together AI, or local LLMs).
4. Paste your API key (links on the page take you to platform.openai.com or console.anthropic.com to create one) and click Save Settings.
5. After saving, the Model dropdown fills with models available to your account — pick one and save again.

You can also set the default card count (15), the creativity level (Temperature), and customize the System Prompt that guides generation.

On the Generator tab, pick an input mode:

• Paste Text — class notes, articles, study guides. More content = better cards; paste at least a paragraph.
• Topic / Idea — just describe what you want, e.g. "The American Revolution — key events, people, and dates". Specific beats general.
• URL / Video — any public web page, or a YouTube/Vimeo link (uses the video's captions; YouTube videos with captions enabled work best).
• Upload PDF — drag & drop a PDF; its text is extracted automatically. Works best with text-based PDFs (scanned images may not extract).
• Image Cards — AI-generated visual cards (see the next section).

Then set Cards (1–100), Difficulty (Easy / Medium / Hard), and Language (type any language — cards generate in it), and click Generate Flashcards. Generation takes roughly 15–60 seconds.

Generated cards appear in a preview where you can click any card text to edit it and remove cards with the × button. Then choose:

• New set — names itself automatically (you can change it) and gives you the shortcode with a Copy button when done.
• Existing set — appends the cards to a set you pick.

From the success screen you can jump straight to Edit Flashcard Set or Generate More Cards.

With an OpenAI key configured under Settings → Image Generation, you can generate images on card faces — or build whole visual decks with the Image Cards mode (front = clean image, back = labeled version).

• Choose the image model, Quality (Low/Medium/High), and Size (square, portrait, landscape).
• Add a style hint ("watercolor illustration, soft pastel palette") and optionally a reference image from your Media Library to keep all cards visually consistent.
• Before generating you can review and edit each image prompt; save your favorite style setups as reusable templates.
• Images generate in small batches with a progress bar and land in your Media Library. Failed images can be retried without regenerating the rest.

The add-on is bring-your-own-key: all AI calls go directly from your site to your provider using your key. Nothing passes through wpflashcard.com, and there are no per-card fees from us — you pay your AI provider's usage rates only.

Who can use it: anyone who can edit posts can generate cards; only administrators see the Settings tab.

• "AI API is not configured" — add and save your API key in the Settings tab.
• Model dropdown empty — the key must be saved before models can load.
• "Failed to parse flashcards" — occasionally the AI returns an unexpected format; just generate again.
• PDF extraction failed — the PDF is probably scanned images; copy the text and use Paste Text instead.
• YouTube "could not extract a transcript" — the video has no captions; paste the content manually.
• Image generation 4xx error — complete OpenAI organization verification.

On the Bulk Paste tab, paste rows of text — one card per line, front and back separated by your chosen Separator (Tab, comma, semicolon, pipe, or double-colon):

What is the capital of France?[TAB]Paris

• Target Set — pick an existing set or type a new set name to create one.
• Mode — append to the set's existing cards, or replace them all (with a confirmation).
• "First line is a header" — check it to skip row 1.
• A live "N cards detected" counter and a Preview button show exactly what will be created before you click Import Cards.

Only the first separator on each line splits the card, so backs can freely contain commas and colons.

On the Export tab, pick a set and a format, then click Download Export:

• CSV — comma-separated with a header row; opens perfectly in Excel.
• Anki — tab-separated .txt with no header, ready for Anki: in Anki go to File → Import, and if you kept HTML, tick "Allow HTML in fields".
• TSV — tab-separated with header; works with Quizlet, Brainscape, and similar apps.

The HTML in cards option lets you keep HTML tags (Anki supports them) or strip to plain text.

Maintain a set's cards in a spreadsheet — great for collaborating:

1. In Google Sheets: File → Share → Publish to web, choose Comma-separated values (.csv), and copy the link.
2. Format: Column A = Front, Column B = Back; row 1 is treated as a header and skipped.
3. In Flashcards → Bulk Toolkit → Google Sheets: choose the target set, paste the link into Published Sheet URL (regular sharing links are converted automatically), and click Sync Now.

• Mode: use "Replace all cards in set (full sync)" to keep the set mirroring the sheet — this is the recommended mode. (Append mode re-adds every sheet row on each sync, so repeated appends create duplicates.)
• Auto-sync: tick the checkbox and click Save Auto-sync Settings to re-sync roughly every hour automatically. Linked sets appear in the Currently Linked Sets table with their last sync time; Unlink stops syncing but keeps the imported cards.

Check that the id in the shortcode matches a published flashcard set (copy it fresh from the Shortcode column on the Flashcards list). A set that exists but has no cards shows "No flashcards in this set." instead.

The URL must end with the file extension and sit on its own line. Remove anything after the extension (like ?ver=2) and make sure the URL isn't sharing a line with other text.

Your key is active on as many sites as your plan allows. Either Deactivate License on a site you no longer use (that frees the slot immediately), or upgrade to a higher plan from your account at wpflashcard.com — you pay only the difference.

Confirm the product's license shows a green active badge on its License page, then visit Dashboard → Updates and click "Check again". Each add-on needs its own active license for updates.

Three things to check: the Animations & Sounds license is active, Read Aloud is enabled in its settings, and the card face actually contains text (media-only faces get no speaker button). Also note a few browsers don't support speech synthesis — the button hides itself there.

The sheet must be published to the web (File → Share → Publish to web → CSV) — normal link-sharing isn't always enough. Also confirm your cards are in columns A and B with a header in row 1.

We're an email away — reach out via the Support page and we'll get you sorted.